MCP Server Terrakube

🚀 地域kube MCP サーバー

Terrakube MCP サーバーは、Terrakube プラットフォームとのインタラクションに使用するツールです。ワークスペース、変数、モジュール、組織などの作成、更新、削除など、様々な機能を提供します。

✨ 主な機能

• 型安全性：すべての入力と出力データが予期される型に一致することを保証します。
• 環境設定：環境変数を設定することでサーバーを構成できます。具体的には以下の通りです。

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

• 自動インストール：Smithery ツールを使用すると自動的にインストールを完了できます。

💻 使用例

基本的な使用法

ワークスペース

• ワークスペースの作成

createWorkspace(name: string, organization: string, provider: string, description?: string) ->_workspaceDetails

• ワークスペースの更新

updateWorkspace(workspaceId: string, name: string, organization: string, provider: string, description?: string) ->updatedWorkspaceDetails

• ワークスペースの削除

deleteWorkspace(workspaceId: string)

• ワークスペースの詳細を取得

getWorkspace(workspaceId: string) ->workspaceDetails

• すべてのワークスペースをリストする

listWorkspaces() ->ListOfWorkspacesResponse

変数

• 変数の作成

createVariable(name: string, organization: string, provider: string, description?: string) ->variableDetails

• 変数の更新

updateVariable(variableId: string, name: string, organization: string, provider: string, description?: string) ->updatedVariableDetails

• 変数の削除

deleteVariable(variableId: string)

• 変数の詳細を取得

getVariable(variableId: string) ->variableDetails

• すべての変数をリストする

listVariables() ->ListOfVariablesResponse

モジュール

• モジュールの作成

createModule(name: string, organization: string, provider: string, description?: string) ->moduleDetails

• モジュールの更新

updateModule(moduleId: string, name: string, organization: string, provider: string, description?: string) ->updatedModuleDetails

• モジュールの削除

deleteModule(moduleId: string)

• モジュールの詳細を取得

getModule(moduleId: string) ->moduleDetails

• すべてのモジュールをリストする

listModules() ->ListOfModulesResponse

組織

• 組織の作成

createOrganization(name: string, description?: string) ->organizationDetails

• 組織の更新

updateOrganization(organizationId: string, name: string, description?: string) ->updatedOrganizationDetails

• 組織の削除

deleteOrganization(organizationId: string)

• 組織の詳細を取得

getOrganization(organizationId: string) ->organizationDetails

• すべての組織をリストする

listOrganizations() ->ListOfOrganizationsResponse

📦 インストール

環境変数

.env ファイルを作成し、以下の内容を記述します。

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

Smithery を使用したインストール

以下のコマンドを実行して自動インストールします。

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_config.json に以下を追加します。

{
  "mcpServers": {
    "terrakube": {
      "command": "npx",
      "args": [
        "-y",
        "@terrakube/mcp-server"
      ],
      "env": {
        "TERRAKUBE_API_URL": "<your-terrakube-api-url>",
        "TERRAKUBE_PAT_TOKEN": "<your-personal-access-token>"
      }
    }
  }
}