mcp-server-hcp-terraform

与HashiCorp Terraform云/企业版API集成的MCP服务器

概述

此项目提供一个MCP服务器，可与HashiCorp Terraform云/企业版API集成。通过MCP，您可以访问搜索Terraform模块和获取模块信息等功能。

先决条件

• Python 3.13+版本
• HashiCorp Terraform云/企业版账户
• 访问令牌

环境变量

在使用前设置以下环境变量：

• HCP_TERRAFORM_TOKEN：HashiCorp Terraform访问令牌（必需）
• HCP_TERRAFORM_ORG：HashiCorp Terraform组织名称（必需）
• HCP_TERRAFORM_BASE_URL：HashiCorp Terraform基础URL（可选，默认值为https://app.terraform.io）

功能

此MCP服务器提供以下功能：

搜索私有模块

使用hcp_terraform_search_private_modules工具在HashiCorp Terraform私有仓库中搜索模块。

参数:

• query：搜索查询
• provider（可选）：提供商过滤器（例如aws、gcp、azure）
• limit（可选）：结果的最大数量（默认值为10）

获取模块详情

使用hcp_terraform_get_module工具获取特定模块在HashiCorp Terraform仓库中的详细信息。

参数:

• module_name：模块名称
• provider：提供商（例如aws、gcp、azure）
• registry_name（可选）：仓库名称（私有或公共，默认为私有）
• namespace（可选）：模块命名空间（未指定时使用组织名称）

使用说明

{
  "globalShortcut": "",
  "mcpServers": {
    "HCP Terraform": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "path/to/mcp-server-hcp-terraform/server.py"
      ],
      "env": {
        "HCP_TERRAFORM_TOKEN": "paste_here",
        "HCP_TERRAFORM_ORG": "my_org"
      }
    }
  }
}

许可证

MIT许可证