compare-mcp

在 Claude Code CLI 中进行带有待办事项排名和子代理派遣的多模型代码审查。

Claude Code 非常擅长代码审查，但它只能与一个模型对话。Copilot CLI 最近推出了多模型调试功能，允许一次性向 GPT、Claude 和 Gemini 抛出问题。Claude Code 原生不支持此功能。此 MCP 服务器添加了该功能：使用您自己的 API 密钥，分发到任意模型组合，并获取它们各自发现的差异化、排名列表。

将任何错误或任务同时分发给多个 LLM，对比它们的独特见解，可选运行模型互相批评的辩论环节，然后派遣并行子代理来实施综合后的最佳修复方案——每个修复方案都有其对应的 git 提交。

演示

https://github.com/user-attachments/assets/8990dabb-bc61-4625-8930-c914cffe75da

/compare models → /compare review config.py for security issues → /compare --debate → /compare status

Related MCP server: Debate Agent MCP

架构

安装

pip install compare-mcp
claude mcp add -s user compare-mcp -- python -m compare_mcp

然后获取 /compare 技能和示例配置：

git clone https://github.com/carolinacherry/compare-mcp.git --depth 1
mkdir -p ~/.claude/skills ~/.compare
cp -r compare-mcp/.claude/skills/compare ~/.claude/skills/
cp compare-mcp/.compare/config.example.json ~/.compare/config.json

快速开始

1. 编辑 ~/.compare/config.json — 通过设置 "enabled": true 并添加您的 API 密钥（作为 $ENV_VAR 引用或直接粘贴密钥）来启用至少 2 个提供商。

2. 在 Claude Code 中：

   /compare memory leak in the tile rendering loop
   /compare race condition in the connection pool --debate --providers claude,openai
   /compare status
   /compare models

配置参考

配置位于 ~/.compare/config.json。API 密钥使用 $ENV_VAR 语法 — 在加载时展开。

提供商类型

比较设置

超时说明： 某些模型（例如 Kimi 的 kimi-k2.5）在处理大型提示词时比 GPT-4o 慢得多，在 60 秒时会超时。我们默认设置为 120 秒。如果某个提供商持续超时，请尝试更快的模型变体 — 对于 Kimi，moonshot-v1-auto 比 kimi-k2.5 更快，并会自动选择正确的上下文窗口。

添加提供商

任何 OpenAI 兼容端点

{
  "my_provider": {
    "enabled": true,
    "type": "openai_compat",
    "api_key": "$MY_API_KEY",
    "model": "model-name",
    "base_url": "https://api.example.com/v1"
  }
}

适用于：OpenAI、Kimi (api.moonshot.ai)、Minimax (api.minimax.io)、Gemini (generativelanguage.googleapis.com/v1beta/openai/)、Ollama API (localhost:11434/v1)、OpenRouter、Together AI、Groq 等。

CLI 子进程模型

{
  "ollama_local": {
    "enabled": true,
    "type": "cli",
    "cli_command": "ollama",
    "cli_args": ["run", "codellama"],
    "cli_parser": "text"
  }
}

cli_parser 选项："text" (原始 stdout)、"json" (解析为 JSON)、"jsonl" (最后一行完整的 JSON)。

命令

在 Claude Code 中，输入以下任一命令：

在 /compare 运行后，系统会询问是否派遣子代理并行修复发现的问题。每个子代理负责一个待办事项，实施修复并提交。

工作原理

1. 分发 — compare_run 通过 asyncio.gather 将代码和问题分发给所有已启用的提供商。超时或出错的提供商会被排除，不会导致整个运行崩溃。

2. 对比 — compare_diff 使用 rapidfuzz (token sort ratio) 对跨提供商的发现进行去重。被 2 个以上提供商发现的问题为“共享”；其余为“独特”。一致性比率 = 共享 / 总独特组。

3. 辩论 (可选) — compare_debate 将每个提供商的发现发送给其他所有提供商进行批评。综合调用会合并结果。限制为最多 4 个提供商以限制 API 调用 (N*(N-1)+1)。

4. 待办事项 — compare_todos 将排名后的发现写入 SQLite。按严重程度优先，然后按提供商数量排序。

5. 执行 — /compare 技能派遣并行的 Claude Code 子代理，每个待办事项一个。每个子代理实施修复并提交。

MCP 工具 (7)

与 multi_mcp 的对比

multi_mcp 在并行分发方面做得很好。compare-mcp 在其之上构建了工作流层：

与 Copilot CLI 多模型对比

Copilot CLI 通过 GitHub 的 API 代理路由 — 不支持自带密钥 (BYO)，不支持 Kimi/Minimax/本地模型。compare-mcp 直接调用提供商 API：拥有完整的上下文窗口、您自己的速率限制，以及任何带有 HTTP 端点或 CLI 二进制文件的模型。

开发

git clone https://github.com/carolinacherry/compare-mcp.git
cd compare-mcp
pip install -e ".[dev]"
pytest
ruff check .