Terrakube MCP 服务器

用于 Terrakube 操作的模型上下文协议 (MCP) 服务器，支持工作区管理、变量处理、模块操作和组织管理。

特征

• 全面的 API 集成：与 Terrakube 的 API 完全集成，实现无缝操作
• 类型安全：使用 TypeScript 构建，以增强类型安全性和开发人员体验
• 错误处理：强大的错误处理功能，提供清晰的错误消息
• 环境配置：通过环境变量灵活配置
• 模块化设计：有组织的代码结构，易于维护和扩展

工具

工作区

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文件，其中包含以下变量：

通过 Smithery 安装

要通过Smithery自动为 Claude Desktop 安装 Terrakube MCP 服务器：

发展

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中：