地域kube MCP 服务器

概述

Terrakube MCP Server 是一个用于与 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>"
      }
    }
  }
}