mcp-server-hcp-terraform

用于与 HashiCorp Terraform Cloud/Enterprise API 交互的 MCP 服务器

概述

本项目提供了一个与 HCP Terraform Cloud/Enterprise API 集成的 MCP 服务器。通过 MCP，您可以访问诸如搜索 Terraform 模块和检索模块信息等功能。

前提条件

• Python 3.13+
• HCP Terraform Cloud/Enterprise 账户
• 访问令牌

环境变量

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

• HCP_TERRAFORM_TOKEN: HCP Terraform 访问令牌 (必需)
• HCP_TERRAFORM_ORG: HCP Terraform 组织名称 (必需)
• HCP_TERRAFORM_BASE_URL: HCP Terraform 基础 URL (可选, 默认: https://app.terraform.io)

功能

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

搜索私有模块

使用 hcp_terraform_search_private_modules 工具搜索 HCP Terraform 私有注册表中的模块。

参数:

• query: 搜索查询
• provider (可选): 提供商过滤器 (例如, aws, gcp, azure)
• limit (可选): 最大结果数 (默认: 10)

获取模块详情

使用 hcp_terraform_get_module 工具从 HCP 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 许可证