使用说明

项目简介

本项目是一个基于 Model Context Protocol (MCP) 的服务器实现，它连接到 Stakpak API，为大型语言模型 (LLM) 客户端提供生成基础设施代码的功能。通过此 MCP 服务器，LLM 应用可以调用 Stakpak API 的能力，根据用户输入的自然语言提示和上下文信息，自动化生成 Terraform、Kubernetes、Dockerfile 和 Github Actions 等基础设施代码。

主要功能点

基础设施代码生成工具: 提供 'generate_infrastructure_code' 工具，根据自然语言描述生成多种平台的基础设施代码。
支持多种配置平台: 可以生成 Terraform, Kubernetes, Dockerfile, Github Actions 代码。
集成 Stakpak API: 利用 Stakpak API 的后端能力进行代码生成。
易于集成: 提供在 Claude Desktop, Cursor, Windsurf 等多种 LLM 客户端的集成配置示例。

安装步骤

克隆仓库:

git clone https://github.com/stakpak/mcp.git
cd mcp

安装依赖:
```
bun install
```
构建项目:
```
bun build
```

服务器配置

要将此 MCP 服务器集成到 MCP 客户端（例如 Cursor, Claude Desktop, Windsurf），您需要配置客户端以启动此服务器。以下是通用的配置信息，您需要根据您的实际环境调整 '<path-to-your-build-file>' 为构建后 'index.js' 文件的路径 (通常在 'dist' 目录下)。

{
 "mcpServers": {
  "stakpak": {
   "command": "node",
   "args": ["<path-to-your-build-file>"],
   "env": {
    "STAKPAK_API_KEY": "<your-stakpak-api-key>" // 替换为您的 Stakpak API 密钥
   }
  }
 }
}

配置参数说明:

'server name': '"stakpak"' (服务器名称，您可以自定义)
'command': '"node"' (启动服务器的命令，这里使用 Node.js 运行环境)
'args': '["<path-to-your-build-file>"]' (传递给命令的参数，需要指定构建后的服务器入口文件路径)
'env': 环境变量配置。
- 'STAKPAK_API_KEY': 您的 Stakpak API 密钥，用于服务器向 Stakpak API 进行身份验证。 请务必替换为您的真实 API 密钥。

不同客户端的配置示例 (无需修改，直接复制到对应客户端的配置文件中即可):

Cursor: 添加到 '.cursor/mcp.json' 文件中。

{
 "mcpServers": {
  "stakpak": {
   "command": "node",
   "args": ["<path-to-your-build-file>"],
   "env": {
    "STAKPAK_API_KEY": "<your-stakpak-api-key>"
   }
  }
 }
}

Claude Desktop: 添加到 'claude_desktop_config.json' 文件中。

{
 "mcpServers": {
  "stakpak": {
   "command": "node",
   "args": ["<path-to-your-build-file>"],
   "env": {
    "STAKPAK_API_KEY": "<your-stakpak-api-key>"
   }
  }
 }
}

Windsurf: 添加到 '~/.codeium/windsurf/mcp_config.json' 文件中。

{
 "mcpServers": {
  "stakpak": {
   "command": "node",
   "args": ["<path-to-your-build-file>"],
   "env": {
    "STAKPAK_API_KEY": "<your-stakpak-api-key>"
   }
  }
 }
}

注意: 请将 '<path-to-your-build-file>' 替换为实际路径，并将 '<your-stakpak-api-key>' 替换为您的 Stakpak API 密钥。

基本使用方法

成功配置 MCP 服务器后，在您的 LLM 客户端中，您可以使用 'generate_infrastructure_code' 工具。该工具接受以下参数：

'prompt': 自然语言描述，说明您想要生成的基础设施代码。
'provisioner': 目标基础设施平台，例如 "Terraform", "Kubernetes", "Dockerfile", "GithubActions"。
'selected_content' (可选): 代码选择内容，作为生成代码的上下文。
'resolve_validation_errors' (可选): 是否尝试自动修复生成的代码中的验证错误。

具体使用方法请参考您使用的 LLM 客户端的文档，通常您可以在客户端中通过类似 '@stakpak/mcp.generate_infrastructure_code' 的方式调用此工具。

关键词