GameCode MCP2

此存储库已迁移至 https://git.navicore.tech/navicore/gamecode-mcp2。

GitHub 上的副本已归档，不再维护。

GameCode MCP2

一种简洁（也可能过于朴素）的模型上下文协议（MCP）工具集成实现。

设计动机：尽可能减少依赖，让配置尽可能简单且易于审计。

⚠️ 安全提示

MCP 仍处于早期阶段。允许大模型执行系统命令本身就有风险。 此实现优先考虑可审计性，而非功能：你可以阅读处理大模型请求的每一行代码。即便如此，也请谨慎使用。只有时间才能证明 MCP 的做法是否可靠。

主要功能

• 直接暴露工具 - 在 tools.yaml 中定义的工具通过 MCP 直接暴露，而非通过元工具
• 简洁的协议实现 - 通过标准输入输出运行纯 JSON-RPC 2.0，无需外部依赖
• 动态加载工具 - 无需重新编译即可通过 YAML 配置工具
• 内置和外部工具 - 同时支持内部处理程序和外部命令

架构

此工作区包含两个 crate：

• mcp-server - 从 tools.yaml 加载工具并通过协议暴露它们的 MCP 服务
• mcp-client - 用于测试和集成的客户端库

用法

运行服务端

# Build the server
cargo build --release --bin gamecode-mcp2

# Create a tools.yaml file (see examples/tools.yaml)
cp examples/tools.yaml .

# Run the server (it communicates via stdio)
./target/release/gamecode-mcp2

与 Claude Desktop 配合使用

添加到 Claude Desktop 配置中：

{
  "mcpServers": {
    "gamecode": {
      "command": "/path/to/gamecode-mcp2"
    }
  }
}

与 gamecode-cli 配合使用

mcp-client crate 可作为依赖项用于 gamecode-cli，以实现 MCP 集成。

工具配置

工具定义在 tools.yaml 中：

tools:
  - name: my_tool
    description: Description for the LLM
    command: /path/to/command  # or "internal" for built-in
    args:
      - name: param1
        description: Parameter description
        required: true
        type: string
        cli_flag: --param  # null for positional
    internal_handler: handler_name  # for internal tools

协议

此实现遵循 MCP 规范：

• initialize - 与客户端握手
• tools/list - 返回所有可用工具
• tools/call - 执行指定工具

工具会直接暴露，而非通过“run”之类的元工具。