MCP Server Hcp Terraform

🚀 mcp-server-hcp-terraform

このプロジェクトは、HashiCorp Terraformクラウド/エンタープライズ版APIと統合可能なMCPサーバーを提供します。MCPを通じて、Terraformモジュールの検索やモジュール情報の取得などの機能を利用できます。

🚀 クイックスタート

このMCPサーバーはHashiCorp Terraformクラウド/エンタープライズ版APIと統合されており、Terraformモジュールの操作が容易になります。

✨ 主な機能

私有モジュールの検索

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ライセンス