MCP Server Terrakube

🚀 地域kube MCP 服务器

Terrakube MCP Server 是一款用于与 Terrakube 平台交互的工具。它具备创建、更新和删除工作区、变量、模块和组织等功能，为用户提供了便捷的操作体验。

✨ 主要特性

• 类型安全：确保所有输入和输出的数据都符合预期类型，保障数据的准确性和可靠性。
• 环境配置：可通过设置环境变量来配置服务器，示例如下：

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

• 自动化安装：使用 Smithery 工具可自动完成安装，节省时间和精力。

📦 安装指南

环境变量设置

创建一个 .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

💻 使用示例

工作区操作

创建工作区

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

📚 详细文档

开发步骤

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