MCP Server Hcp Terraform

🚀 mcp-server-hcp-terraform

本項目提供的MCP服務器，可與HashiCorp Terraform雲/企業版API集成。藉助該服務器，用戶能夠搜索Terraform模塊並獲取模塊信息。

🚀 快速開始

此項目提供一個MCP服務器，可與HashiCorp Terraform雲/企業版API集成。通過MCP，您可以訪問搜索Terraform模塊和獲取模塊信息等功能。

✨ 主要特性

此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（可選）：模塊命名空間（未指定時使用組織名稱）

📦 安裝指南

先決條件

• 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）

💻 使用示例

基礎用法

{
  "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許可證。