Terrakube MCP Server
Terrakube MCP 服务器
用于 Terrakube 操作的模型上下文协议 (MCP) 服务器,支持工作区管理、变量处理、模块操作和组织管理。
特征
全面的 API 集成:与 Terrakube 的 API 完全集成,实现无缝操作
类型安全:使用 TypeScript 构建,以增强类型安全性和开发人员体验
错误处理:强大的错误处理功能,提供清晰的错误消息
环境配置:通过环境变量灵活配置
模块化设计:有组织的代码结构,易于维护和扩展
Related MCP server: Coolify MCP Server
工具
工作区
createWorkspace
在 Terrakube 中创建一个新的工作区。
输入:
name(字符串):工作区的名称organization(字符串):组织名称description(可选字符串):工作区描述vcsProviderId(可选字符串):VCS 提供程序 IDvcsRepository(可选字符串):VCS 存储库名称vcsBranch(可选字符串):VCS 分支名称
返回:创建的工作区详细信息
updateWorkspace
更新现有工作区。
输入:
name(字符串):工作区的名称organization(字符串):组织名称description(可选字符串):新工作区描述vcsProviderId(可选字符串):新的 VCS 提供程序 IDvcsRepository(可选字符串):新的 VCS 存储库名称vcsBranch(可选字符串):新的 VCS 分支名称
返回:更新的工作区详细信息
deleteWorkspace
删除工作区。
输入:
name(字符串):工作区的名称organization(字符串):组织名称
返回:成功状态
getWorkspace
获取特定工作区的详细信息。
输入:
name(字符串):工作区的名称organization(字符串):组织名称
返回:工作区详细信息
listWorkspaces
列出组织中的所有工作区。
输入:
organization(字符串):组织名称
返回:工作区详细信息数组
变量
createVariable
在工作区中创建一个新变量。
输入:
name(字符串):变量的名称organization(字符串):组织名称workspace(字符串):工作区名称value(字符串):变量值description(可选字符串):变量描述category(可选字符串):变量类别hcl(可选布尔值):变量是否为 HCLsensitive(可选布尔值):变量是否敏感
返回:创建的变量详细信息
updateVariable
更新现有变量。
输入:
name(字符串):变量的名称organization(字符串):组织名称workspace(字符串):工作区名称value(字符串):新的变量值description(可选字符串):新变量描述category(可选字符串):新的变量类别hcl(可选布尔值):变量是否为 HCLsensitive(可选布尔值):变量是否敏感
返回:更新后的变量详细信息
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文件,其中包含以下变量:
TERRAKUBE_API_URL=<your-terrakube-api-url>
TERRAKUBE_PAT_TOKEN=<your-personal-access-token>通过 Smithery 安装
要通过Smithery自动为 Claude Desktop 安装 Terrakube MCP 服务器:
npx -y @smithery/cli install @AzBuilder/mcp-server-terrakube --client claude发展
克隆存储库:
git clone https://github.com/azbuilder/terrakube-mcp-server.git cd terrakube-mcp-server安装依赖项:
npm install构建项目:
npm run build
与 Claude Desktop 一起使用
要将其与 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>"
}
}
}
}Available Tools
16 toolscreate-moduleC
Creates a new module in the specified organization
Inputs: name (required), organizationId (required), provider (required), registry (required), +1 more.
create-organizationC
Creates a new organization with the specified name and optional description
Inputs: name (required), description.
create-variableC
Creates a new variable in the specified workspace
Inputs: key (required), organizationId (required), value (required), workspaceId (required), +3 more.
create-workspaceC
Creates a new workspace in the specified organization
Inputs: name (required), organizationId (required), terraformVersion (required), description, +2 more.
edit-moduleC
Updates an existing module's details
Inputs: moduleId (required), organizationId (required), description, name, +2 more.
edit-organizationC
Updates an existing organization's details
Inputs: id (required), description, name.
edit-variableC
Updates an existing variable's details
Inputs: organizationId (required), variableId (required), workspaceId (required), category, +4 more.
edit-workspaceC
Updates an existing workspace's details
Inputs: organizationId (required), workspaceId (required), description, name, +3 more.
get-moduleC
Retrieves detailed information about a specific module
Inputs: moduleId (required), organizationId (required).
get-organizationB
Retrieves detailed information about a specific organization by its ID
Inputs: id (required).
get-variableC
Retrieves detailed information about a specific variable
Inputs: organizationId (required), variableId (required), workspaceId (required).
get-workspaceC
Retrieves detailed information about a specific workspace
Inputs: organizationId (required), workspaceId (required).
list-modulesB
Lists all modules in the specified organization
Inputs: organizationId (required).
list-organizationsB
Lists all organizations accessible to the current user
Inputs: no named parameters.
list-variablesB
Lists all variables in the specified workspace
Inputs: organizationId (required), workspaceId (required).
list-workspacesC
Lists all workspaces in the specified organization
Inputs: organizationId (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 16 tools
Every tool has a clearly distinct purpose with no ambiguity, as each combines a specific action (create, edit, get, list) with a specific resource type (module, organization, variable, workspace). The descriptions reinforce this clarity, making misselection unlikely.
Tool names follow a perfectly consistent verb-noun pattern throughout, using hyphen-separated lowercase (e.g., create-module, edit-organization). All tools adhere to this convention without any deviations or mixed styles.
With 16 tools, the count is well-scoped for managing Terraform-like resources (modules, organizations, variables, workspaces). Each tool earns its place by covering CRUD operations across four resource types, avoiding bloat or thinness.
The tool set provides complete CRUD/lifecycle coverage for the inferred domain of infrastructure management, with create, edit, get, and list operations for all four resource types. There are no obvious gaps or dead ends in the surface.
Maintenance
Related MCP Connectors
A Model Context Protocol server for Wix AI tools
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
The Mercado Pago MCP Server implements the Model Context Protocol to provide AI agents and LLMs with access to Mercado Pago's APIs and tools within compatible development environments. It acts as an intermediary that translates Mercado Pago resources into executable functions (tools) that AI applications can invoke to perform actions and automate flows. The server simplifies integration, enables using documentation to implement or improve code, and optimizes operations through natural language interactions without manual implementations.
The Telnyx MCP server is an official implementation of the Model Context Protocol that enables AI clients (like Claude Desktop, Cursor, and OpenAI Agents) to interact with Telnyx's telephony, messaging, and AI assistant APIs. It provides comprehensive capabilities including making and managing phone calls, sending SMS/MMS messages, purchasing and configuring phone numbers, creating AI assistants with custom instructions, managing cloud storage buckets, scraping and embedding website content, and handling integration secrets. The server exists as both a local implementation and a remotely hosted version, allowing developers to integrate real-world communication infrastructure directly into AI applications.
Related MCP Servers
- AlicenseAqualityDmaintenanceA Model Context Protocol (MCP) server that integrates Claude with the Terraform Cloud API, allowing Claude to manage your Terraform infrastructure through natural conversation.6223MIT
- AlicenseNot gradedqualityAmaintenanceA Model Context Protocol server that enables AI assistants to interact with Coolify instances through natural language, allowing management of servers, applications, databases, and deployments.6,575 npm626MIT
- FlicenseAqualityDmaintenanceA containerized Model Context Protocol server that enables using natural language to develop AWS infrastructure with Terraform, offering best practices guidance, security scanning with Checkov, and access to AWS provider documentation.7-
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that enables CRUD operations and querying on Microsoft Dataverse through natural language.MIT