Terrakube

🚀 土壤立方體 MCP 服務器

Terrakube MCP 服務器是一款用於與 Terrakube 平臺集成的模型上下文協議 (MCP) 服務器。它提供了一系列 API 接口，可用於管理工作空間、變量、模塊和組織等資源，為用戶提供便捷的資源管理體驗。

🚀 快速開始

Terrakube MCP 服務器提供了豐富的 API 接口，可用於管理工作空間、變量、模塊和組織等資源。通過以下步驟，你可以快速配置和使用該服務器，並與 Claude Desktop 集成。

✨ 主要特性

• 工作空間管理：支持創建、更新、刪除和獲取工作空間。
• 變量管理：可對與工作空間相關的變量進行操作。
• 模塊管理：能夠處理模塊的生命週期。
• 組織管理：實現組織的創建、更新和刪除功能。
• 環境配置：可通過設置環境變量來配置服務器運行時參數。

📦 安裝指南

環境變量配置

在項目根目錄下創建一個 .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>"
      }
    }
  }
}

💻 使用示例

基礎用法

以下是使用 Terrakube MCP Server 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;

高級用法

在實際應用中，你可以結合多個 API 接口，實現更復雜的資源管理場景。例如，在創建工作空間後，立即為其創建相關變量：

// 創建工作空間
const workspace = createWorkspace('myWorkspace', 'myOrganization', 'This is a test workspace');

// 為工作空間創建變量
createVariable(workspace.id, 'myKey', 'myValue', 'This is a test variable');

📚 詳細文檔

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 集成。