Terrakube MCP Server

Terrakube MCP サーバー

ワークスペース管理、変数の処理、モジュール操作、組織管理を可能にする、Terrakube 操作用の Model Context Protocol（MCP）サーバーです。

機能

• 包括的な API 統合：Terrakube の API と完全に統合し、シームレスな操作を実現します
• 型安全性：TypeScript で構築されており、型安全性と開発者エクスペリエンスを向上させます
• エラー処理：明確なエラーメッセージを備えた堅牢なエラー処理です
• 環境設定：環境変数を使用して柔軟に設定できます
• モジュール設計：保守や拡張が容易なコード構成です

ツール

ワークスペース

createWorkspace

Terrakube に新しいワークスペースを作成します。

• 入力：
  • name (string)：ワークスペース名
  • organization (string)：組織名
  • description (optional string)：ワークスペースの説明
  • vcsProviderId (optional string)：VCS プロバイダー ID
  • vcsRepository (optional string)：VCS リポジトリ名
  • vcsBranch (optional string)：VCS ブランチ名
• 戻り値：作成されたワークスペースの詳細

updateWorkspace

既存のワークスペースを更新します。

• 入力：
  • name (string)：ワークスペース名
  • organization (string)：組織名
  • description (optional string)：新しいワークスペースの説明
  • vcsProviderId (optional string)：新しい VCS プロバイダー ID
  • vcsRepository (optional string)：新しい VCS リポジトリ名
  • vcsBranch (optional string)：新しい VCS ブランチ名
• 戻り値：更新されたワークスペースの詳細

deleteWorkspace

ワークスペースを削除します。

• 入力：
  • name (string)：ワークスペース名
  • organization (string)：組織名
• 戻り値：成功ステータス

getWorkspace

指定したワークスペースの詳細を取得します。

• 入力：
  • name (string)：ワークスペース名
  • organization (string)：組織名
• 戻り値：ワークスペースの詳細

listWorkspaces

組織内のすべてのワークスペースを一覧表示します。

• 入力：
  • organization (string)：組織名
• 戻り値：ワークスペースの詳細の配列

変数

createVariable

ワークスペースに新しい変数を作成します。

• 入力：
  • name (string)：変数名
  • organization (string)：組織名
  • workspace (string)：ワークスペース名
  • value (string)：変数の値
  • description (optional string)：変数の説明
  • category (optional string)：変数のカテゴリ
  • hcl (optional boolean)：変数が HCL かどうか
  • sensitive (optional boolean)：変数が機密情報かどうか
• 戻り値：作成された変数の詳細

updateVariable

既存の変数を更新します。

• 入力：
  • name (string)：変数名
  • organization (string)：組織名
  • workspace (string)：ワークスペース名
  • value (string)：新しい変数の値
  • description (optional string)：新しい変数の説明
  • category (optional string)：新しい変数のカテゴリ
  • hcl (optional boolean)：変数が HCL かどうか
  • sensitive (optional boolean)：変数が機密情報かどうか
• 戻り値：更新された変数の詳細

deleteVariable

変数を削除します。

• 入力：
  • name (string)：変数名
  • organization (string)：組織名
  • workspace (string)：ワークスペース名
• 戻り値：成功ステータス

getVariable

特定の変数の詳細を取得します。

• Inputs:
  • name (string): 変数名
  • organization (string): 組織名
  • workspace (string): ワークスペース名
• Returns: 変数の詳細

listVariables

ワークスペース内のすべての変数を一覧表示します。

• Inputs:
  • organization (string): 組織名
  • workspace (string): ワークスペース名
• Returns: 変数の詳細の配列

モジュール

createModule

新しいモジュールを作成します。

• Inputs:
  • name (string): モジュール名
  • organization (string): 組織名
  • provider (string): モジュールプロバイダー
  • description (optional string): モジュールの説明
• Returns: 作成されたモジュールの詳細

updateModule

既存のモジュールを更新します。

• Inputs:
  • name (string): モジュール名
  • organization (string): 組織名
  • provider (string): モジュールプロバイダー
  • description (optional string): 新しいモジュールの説明
• Returns: 更新されたモジュールの詳細

deleteModule

モジュールを削除します。

• Inputs:
  • name (string): モジュール名
  • organization (string): 組織名
  • provider (string): モジュールプロバイダー
• Returns: 成功ステータス

getModule

特定のモジュールの詳細を取得します。

• Inputs:
  • name (string): モジュール名
  • organization (string): 組織名
  • provider (string): モジュールプロバイダー
• Returns: モジュールの詳細

listModules

組織内のすべてのモジュールを一覧表示します。

• Inputs:
  • organization (string): 組織名
• Returns: モジュールの詳細の配列

組織

createOrganization

新しい組織を作成します。

• Inputs:
  • name (string): 組織名
  • description (optional string): 組織の説明
• Returns: 作成された組織の詳細

updateOrganization

既存の組織を更新します。

• Inputs:
  • name (string): 組織名
  • description (optional string): 新しい組織の説明
• Returns: 更新された組織の詳細

deleteOrganization

組織を削除します。

• Inputs:
  • name (string): 組織名
• Returns: 成功ステータス

getOrganization

特定の組織の詳細を取得します。

• Inputs:
  • name (string): 組織名
• Returns: 組織の詳細

listOrganizations

すべての組織を一覧表示します。

• Returns: 組織の詳細の配列

セットアップ

環境変数

ルートディレクトリに .env ファイルを作成し、次の変数を設定します。

TERRAKUBE_API_URL=<your-terrakube-api-url>
TERRAKUBE_PAT_TOKEN=<your-personal-access-token>

Smithery 経由でのインストール

Smithery 経由で Terrakube MCP Server を Claude Desktop に自動的にインストールするには、次の手順を実行します。

npx -y @smithery/cli install @AzBuilder/mcp-server-terrakube --client claude

開発

1. リポジトリをクローンします。

   git clone https://github.com/azbuilder/terrakube-mcp-server.git
   cd terrakube-mcp-server
   

2. 依存関係をインストールします。

   npm install
   

3. プロジェクトをビルドします。

   npm run build
   

Claude Desktop での使用

Claude Desktop で使用するには、claude_desktop_config.json に次の設定を追加します。

{
  "mcpServers": {
    "terrakube": {
      "command": "npx",
      "args": [
        "-y",
        "@terrakube/mcp-server"
      ],
      "env": {
        "TERRAKUBE_API_URL": "<YOUR_API_URL>",
        "TERRAKUBE_PAT_TOKEN": "<YOUR_PAT_TOKEN>"
      }
    }
  }
}