土壤立方体 MCP 服务器

项目描述

Terrakube MCP Server 是一个用于与 Terrakube 平台集成的模型上下文协议 (MCP) 服务器。它提供了一系列 API 接口，用于管理工作空间、变量、模块和组织等资源。

特性

• 工作空间管理：创建、更新、删除和获取工作空间。
• 变量管理：操作与工作空间相关的变量。
• 模块管理：处理模块的生命周期。
• 组织管理：实现组织的创建、更新和删除功能。
• 环境配置：通过设置环境变量来配置服务器运行时参数。

安装指南

环境变量配置

在项目根目录下创建一个 .env 文件，添加以下变量：

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

使用 Smithery 安装

通过 Smithery 自动安装 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_config.json 中添加以下配置：

{
  "mcpServers": {
    "terrakube": {
      "command": "npx",
      "args": [
        "-y",
        "@terrakube/mcp-server"
      ],
      "env": {
        "TERRAKUBE_API_URL": "<YOUR_API_URL>",
        "TERRAKUBE_PAT_TOKEN": "<YOUR_PAT_TOKEN>"
      }
    }
  }
}

API 接口参考

工作空间管理

创建工作空间

createWorkspace(name: string, organization: string, description?: string) => WorkspaceDetails;

更新工作空间

updateWorkspace(workspaceId: string, name: string, organization: string, description?: string) => UpdatedWorkspace;

删除工作空间

deleteWorkspace(workspaceId: string) => boolean;

获取工作空间详情

getWorkspace(workspaceId: string) => WorkspaceDetails;

变量管理

创建变量

createVariable(workspaceId: string, key: string, value: string, description?: string) => Variable;

更新变量

updateVariable(variableId: string, workspaceId: string, key: string, value: string, description?: string) => UpdatedVariable;

模块管理

创建模块

createModule(name: string, organization: string, provider: string, description?: string) => ModuleDetails;

更新模块

updateModule(moduleId: string, name: string, organization: string, provider: string, description?: string) => UpdatedModule;

组织管理

创建组织

createOrganization(name: string, description?: string) => OrganizationDetails;

更新组织

updateOrganization(organizationId: string, name: string, description?: string) => UpdatedOrganization;

项目徽章

通过以上步骤，您可以轻松配置和使用 Terrakube MCP Server，并与 Claude Desktop 集成。