Skip to main content
Glama
Terrakube MCP Server

Terrakube MCP Server

by terrakube-io

Terrakube MCP サーバー

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

特徴

  • 包括的なAPI統合:TerrakubeのAPIとの完全な統合によりシームレスな運用が可能

  • 型安全性: 型安全性と開発者エクスペリエンスを強化するために TypeScript で構築されています

  • エラー処理: 明確なエラーメッセージによる堅牢なエラー処理

  • 環境設定: 環境変数による柔軟な設定

  • モジュラー設計: メンテナンスと拡張を容易にする整理されたコード構造

Related MCP server: Coolify MCP Server

ツール

ワークスペース

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

Available Tools

16 tools
create-moduleC

Creates a new module in the specified organization

Inputs: name (required), organizationId (required), provider (required), registry (required), +1 more.

create-organizationC

Creates a new organization with the specified name and optional description

Inputs: name (required), description.

create-variableC

Creates a new variable in the specified workspace

Inputs: key (required), organizationId (required), value (required), workspaceId (required), +3 more.

create-workspaceC

Creates a new workspace in the specified organization

Inputs: name (required), organizationId (required), terraformVersion (required), description, +2 more.

edit-moduleC

Updates an existing module's details

Inputs: moduleId (required), organizationId (required), description, name, +2 more.

edit-organizationC

Updates an existing organization's details

Inputs: id (required), description, name.

edit-variableC

Updates an existing variable's details

Inputs: organizationId (required), variableId (required), workspaceId (required), category, +4 more.

edit-workspaceC

Updates an existing workspace's details

Inputs: organizationId (required), workspaceId (required), description, name, +3 more.

get-moduleC

Retrieves detailed information about a specific module

Inputs: moduleId (required), organizationId (required).

get-organizationB

Retrieves detailed information about a specific organization by its ID

Inputs: id (required).

get-variableC

Retrieves detailed information about a specific variable

Inputs: organizationId (required), variableId (required), workspaceId (required).

get-workspaceC

Retrieves detailed information about a specific workspace

Inputs: organizationId (required), workspaceId (required).

list-modulesB

Lists all modules in the specified organization

Inputs: organizationId (required).

list-organizationsB

Lists all organizations accessible to the current user

Inputs: no named parameters.

list-variablesB

Lists all variables in the specified workspace

Inputs: organizationId (required), workspaceId (required).

list-workspacesC

Lists all workspaces in the specified organization

Inputs: organizationId (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 16 tools

    Disambiguation5/5

    Every tool has a clearly distinct purpose with no ambiguity, as each combines a specific action (create, edit, get, list) with a specific resource type (module, organization, variable, workspace). The descriptions reinforce this clarity, making misselection unlikely.

    Naming Consistency5/5

    Tool names follow a perfectly consistent verb-noun pattern throughout, using hyphen-separated lowercase (e.g., create-module, edit-organization). All tools adhere to this convention without any deviations or mixed styles.

    Tool Count5/5

    With 16 tools, the count is well-scoped for managing Terraform-like resources (modules, organizations, variables, workspaces). Each tool earns its place by covering CRUD operations across four resource types, avoiding bloat or thinness.

    Completeness5/5

    The tool set provides complete CRUD/lifecycle coverage for the inferred domain of infrastructure management, with create, edit, get, and list operations for all four resource types. There are no obvious gaps or dead ends in the surface.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      A Model Context Protocol (MCP) server that integrates Claude with the Terraform Cloud API, allowing Claude to manage your Terraform infrastructure through natural conversation.
      62
      23
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      A Model Context Protocol server that enables AI assistants to interact with Coolify instances through natural language, allowing management of servers, applications, databases, and deployments.
      6,409 npm
      625
      MIT
    • F
      license
      A
      quality
      D
      maintenance
      A containerized Model Context Protocol server that enables using natural language to develop AWS infrastructure with Terraform, offering best practices guidance, security scanning with Checkov, and access to AWS provider documentation.
      7
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server that enables CRUD operations and querying on Microsoft Dataverse through natural language.
      MIT