Terrakube MCP Server

by AzBuilder
Verified

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Uses .ENV for flexible configuration through environment variables, allowing users to set Terrakube API URL, personal access token, and organization name.

  • Packaged as an npm module (@terrakube/mcp-server-terrakube) that can be installed and executed with npx.

  • Built with TypeScript for enhanced type safety and developer experience when interfacing with Terrakube's API.

Terrakube MCP サーバー

Terrakube 操作用のモデル コンテキスト プロトコル (MCP) サーバー。ワークスペース管理、変数処理、モジュール操作、組織管理を可能にします。

特徴

  • 包括的なAPI統合:TerrakubeのAPIとの完全な統合によりシームレスな運用が可能
  • 型安全性: 型安全性と開発者エクスペリエンスを強化するために TypeScript で構築されています
  • エラー処理: 明確なエラーメッセージによる堅牢なエラー処理
  • 環境設定: 環境変数による柔軟な設定
  • モジュラー設計: メンテナンスと拡張を容易にする整理されたコード構造

ツール

ワークスペース

createWorkspace

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

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

updateWorkspace

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

  • 入力:
    • name (文字列): ワークスペースの名前
    • organization (文字列): 組織名
    • description (オプションの文字列): 新しいワークスペースの説明
    • vcsProviderId (オプションの文字列): 新しいVCSプロバイダーID
    • vcsRepository (オプションの文字列): 新しいVCSリポジトリ名
    • vcsBranch (オプションの文字列): 新しいVCSブランチ名
  • 返品: ワークスペースの詳細を更新しました

deleteWorkspace

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

  • 入力:
    • name (文字列): ワークスペースの名前
    • organization (文字列): 組織名
  • 戻り値: 成功ステータス

getWorkspace

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

  • 入力:
    • name (文字列): ワークスペースの名前
    • organization (文字列): 組織名
  • 戻り値: ワークスペースの詳細

listWorkspaces

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

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

変数

createVariable

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

  • 入力:
    • name (文字列): 変数の名前
    • organization (文字列): 組織名
    • workspace (文字列): ワークスペース名
    • value (文字列): 変数値
    • description (オプションの文字列): 変数の説明
    • category (オプションの文字列):変数カテゴリ
    • hcl (オプションのブール値): 変数がHCLかどうか
    • sensitive (オプションのブール値):変数が敏感かどうか
  • 戻り値: 作成された変数の詳細

updateVariable

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

  • 入力:
    • name (文字列): 変数の名前
    • organization (文字列): 組織名
    • workspace (文字列): ワークスペース名
    • value (文字列): 新しい変数値
    • description (オプションの文字列): 新しい変数の説明
    • category (オプションの文字列):新しい変数カテゴリ
    • hcl (オプションのブール値): 変数がHCLかどうか
    • sensitive (オプションのブール値):変数が敏感かどうか
  • 戻り値: 更新された変数の詳細

deleteVariable

変数を削除します。

  • 入力:
    • name (文字列): 変数の名前
    • organization (文字列): 組織名
    • workspace (文字列): ワークスペース名
  • 戻り値: 成功ステータス

getVariable

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

  • 入力:
    • name (文字列): 変数の名前
    • organization (文字列): 組織名
    • workspace (文字列): ワークスペース名
  • 戻り値: 変数の詳細

listVariables

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

  • 入力:
    • organization (文字列): 組織名
    • workspace (文字列): ワークスペース名
  • 戻り値: 変数の詳細の配列

モジュール

createModule

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

  • 入力:
    • name (文字列): モジュールの名前
    • organization (文字列): 組織名
    • provider (文字列): モジュールプロバイダー
    • description (オプションの文字列): モジュールの説明
  • 戻り値: 作成されたモジュールの詳細

updateModule

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

  • 入力:
    • name (文字列): モジュールの名前
    • organization (文字列): 組織名
    • provider (文字列): モジュールプロバイダー
    • description (オプションの文字列): 新しいモジュールの説明
  • 戻り値: 更新されたモジュールの詳細

deleteModule

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

  • 入力:
    • name (文字列): モジュールの名前
    • organization (文字列): 組織名
    • provider (文字列): モジュールプロバイダー
  • 戻り値: 成功ステータス

getModule

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

  • 入力:
    • name (文字列): モジュールの名前
    • organization (文字列): 組織名
    • provider (文字列): モジュールプロバイダー
  • 戻り値: モジュールの詳細

listModules

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

  • 入力:
    • organization (文字列): 組織名
  • 戻り値: モジュールの詳細の配列

組織

createOrganization

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

  • 入力:
    • name (文字列): 組織名
    • description (オプションの文字列): 組織の説明
  • 戻り値: 作成された組織の詳細

updateOrganization

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

  • 入力:
    • name (文字列): 組織名
    • description (オプションの文字列): 新しい組織の説明
  • 返品: 組織の詳細を更新しました

deleteOrganization

組織を削除します。

  • 入力:
    • name (文字列): 組織名
  • 戻り値: 成功ステータス

getOrganization

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

  • 入力:
    • name (文字列): 組織名
  • 返品:組織の詳細

listOrganizations

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

  • 戻り値: 組織の詳細の配列

設定

環境変数

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

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

Smithery経由でインストール

Smithery経由で Claude Desktop 用の Terrakube MCP Server を自動的にインストールするには:

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>" } } } }

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

自然言語による Terrakube インフラストラクチャの管理、ワークスペース管理、変数、モジュール、組織操作の処理を可能にするモデル コンテキスト プロトコル サーバー。

  1. Features
    1. Tools
      1. Workspaces
      2. Variables
      3. Modules
      4. Organizations
    2. Setup
      1. Environment Variables
      2. Installing via Smithery
      3. Development
      4. Usage with Claude Desktop
    ID: lomk5z9d0a