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 服务器:

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
    ResponsivenessOutdated data

    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,575 npm
      626
      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