项目简介

GCode Agent 是一个用于生成 SaaS 应用程序的 AI 代理工具，它通过读取规范模板，利用 Gemini 模型生成代码计划并逐步构建应用程序。其中，GCode Agent MCP 服务器作为 GCode Agent 工具的后端组件，通过 Model Context Protocol (MCP) 向兼容的 LLM 客户端（如 Claude Desktop）暴露其核心功能，使得 LLM 客户端能够远程调用 GCode Agent 的能力，例如项目初始化、代码生成、配置管理以及访问规范资源等。

主要功能点

资源管理: 通过 MCP 协议提供对项目规范文件 ('spec/*.md') 的访问，允许 LLM 客户端读取和利用这些规范文件作为上下文信息。
工具注册与执行: 注册了一系列工具，包括：
- 'initialize_project': 初始化一个新的 gcode-agent 项目。
- 'generate_step': 根据项目规范生成指定步骤的代码或计划。
- 'get_config_value': 获取 gcode-agent 配置信息。
- 'set_config_value': 设置 gcode-agent 配置信息，例如模型名称。
标准 MCP 协议: 使用 JSON-RPC over HTTP 与客户端通信，符合 MCP 协议规范。
会话管理与能力声明: MCP 服务器负责会话管理，并声明自身提供的工具和资源。

安装步骤

克隆仓库:

git clone https://github.com/rajpdus/gcode-saas
cd gcode-saas/gcode-agent-cli

创建并激活虚拟环境 (推荐):

python -m venv venv
source venv/bin/activate   # Linux/macOS
# venv\Scripts\activate.bat  # Windows

安装依赖:

pip install -r requirements.txt

设置 Gemini API 密钥: 设置环境变量 'GEMINI_API_KEY' 为您的 Google AI API 密钥。

export GEMINI_API_KEY='YOUR_API_KEY'  # Linux/macOS
# set GEMINI_API_KEY=YOUR_API_KEY     # Windows

服务器配置

以下 JSON 配置信息可用于 MCP 客户端连接 GCode Agent MCP 服务器。您需要将 'command' 替换为实际的服务器启动命令路径，通常是 'gcode_agent.py' 脚本的路径。

{
  "serverName": "GCode Agent MCP Server",
  "command": "./gcode_agent.py",
  "args": [
    "serve-mcp"
  ],
  "transports": [
    {
      "type": "stdio"
    },
    {
      "type": "websocket",
      "url": "ws://127.0.0.1:8000"
    },
    {
      "type": "sse",
      "url": "http://127.0.0.1:8000"
    }
  ],
  "capabilities": [
    "resources",
    "tools"
  ]
}

参数注释:

'serverName': MCP 服务器的名称，用于在客户端显示。
'command': 启动 MCP 服务器的命令。这里假设 'gcode_agent.py' 脚本在当前目录下，并使用 './gcode_agent.py' 运行。请根据您的实际脚本路径进行调整。
'args': 传递给启动命令的参数。'serve-mcp' 参数指示启动 MCP 服务器模式。
'transports': 服务器支持的传输协议列表。
- 'stdio': 标准输入输出流。
- 'websocket': WebSocket 协议，默认监听 'ws://127.0.0.1:8000'。
- 'sse': Server-Sent Events 协议，默认监听 'http://127.0.0.1:8000'。
'capabilities': 服务器声明提供的能力，包括资源管理 ('resources') 和工具调用 ('tools')。

注意: 如果需要修改服务器监听地址或端口，可以修改 'args' 数组，例如使用 '["serve-mcp", "--host", "0.0.0.0", "--port", "8088"]'。

基本使用方法

启动 MCP 服务器: 在 'gcode-agent-cli' 目录下执行以下命令启动 MCP 服务器：

./gcode_agent.py serve-mcp

或指定端口:

./gcode_agent.py serve-mcp --port 8088

使用 MCP 客户端连接: 使用兼容 MCP 协议的客户端 (如 Claude Desktop)，根据上述 服务器配置 填入配置信息，连接到 GCode Agent MCP 服务器。
在客户端中操作: 连接成功后，您可以在 MCP 客户端中：
- 调用 'initialize_project' 工具初始化项目。
- 调用 'generate_step' 工具生成代码步骤。
- 使用 'get_config_value' 和 'set_config_value' 管理配置。
- 访问 'spec://' 资源获取规范文件内容。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息