Terrakube

🚀 土壤立方体 MCP サーバー

Terrakube MCP サーバーは、Terrakube プラットフォームと統合するためのモデルコンテキストプロトコル (MCP) サーバーです。ワークスペース、変数、モジュール、組織などのリソースを管理するための一連の API インターフェースを提供します。

🚀 クイックスタート

Terrakube MCP サーバーを使用することで、Terrakube プラットフォームとの統合を通じて、ワークスペースや変数、モジュール、組織などのリソースを簡単に管理できます。以下の手順に従って、サーバーをセットアップして使用しましょう。

✨ 主な機能

• ワークスペース管理：ワークスペースの作成、更新、削除、取得が可能です。
• 変数管理：ワークスペースに関連する変数を操作できます。
• モジュール管理：モジュールのライフサイクルを処理します。
• 組織管理：組織の作成、更新、削除機能を実現します。
• 環境設定：環境変数を設定することで、サーバーの実行時パラメータを構成できます。

📦 インストール

環境変数の設定

プロジェクトのルートディレクトリに .env ファイルを作成し、以下の変数を追加します。

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

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

Smithery を通じて Terrakube MCP サーバーを自動インストールします。

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_API_URL>",
        "TERRAKUBE_PAT_TOKEN": "<YOUR_PAT_TOKEN>"
      }
    }
  }
}

💻 使用例

基本的な使用法

以下は、Terrakube MCP サーバーの API を使用してワークスペースを作成する基本的なコード例です。

// ワークスペースを作成する関数
createWorkspace(name: string, organization: string, description?: string) => WorkspaceDetails;

高度な使用法

以下は、ワークスペースを更新する高度なコード例です。

// ワークスペースを更新する関数
updateWorkspace(workspaceId: string, name: string, organization: string, description?: string) => UpdatedWorkspace;

📚 ドキュメント

API インターフェースリファレンス

ワークスペース管理

• ワークスペースの作成

createWorkspace(name: string, organization: string, description?: string) => WorkspaceDetails;

• ワークスペースの更新

updateWorkspace(workspaceId: string, name: string, organization: string, description?: string) => UpdatedWorkspace;

• ワークスペースの削除

deleteWorkspace(workspaceId: string) => boolean;

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

getWorkspace(workspaceId: string) => WorkspaceDetails;

変数管理

• 変数の作成

createVariable(workspaceId: string, key: string, value: string, description?: string) => Variable;

• 変数の更新

updateVariable(variableId: string, workspaceId: string, key: string, value: string, description?: string) => UpdatedVariable;

モジュール管理

• モジュールの作成

createModule(name: string, organization: string, provider: string, description?: string) => ModuleDetails;

• モジュールの更新

updateModule(moduleId: string, name: string, organization: string, provider: string, description?: string) => UpdatedModule;

組織管理

• 組織の作成

createOrganization(name: string, description?: string) => OrganizationDetails;

• 組織の更新

updateOrganization(organizationId: string, name: string, description?: string) => UpdatedOrganization;

🔗 プロジェクトバッジ

以上の手順に従えば、Terrakube MCP サーバーを簡単に設定して使用し、Claude Desktop と統合することができます。