Claude-concilium

关闭Concilium

通过MCP为Claude Code提供多代理人工智能咨询框架。

当仅靠Claude Code是不够的时，从其他LLM那里获得第二（和第三）种意见。

Claude Code ──┬── OpenAI (Codex CLI) ──► Opinion A
              ├── Gemini (gemini-cli) ─► Opinion B
              │
              └── Synthesis ◄── Consensus or iterate

问题

Claude Code功能强大，但一个大脑可能会错过错误、忽视边缘情况或陷入局部最优。关键决策受益于不同的视角。

解决方案

Concilium通过标准与多个LLM进行并行协商 MCP协议.每个LLM服务器包装一个CLI工具-主提供程序不需要API密钥（它们使用OAuth）。

主要特点：

• 与2+AI代理进行平行咨询
• 具有错误检测功能的生产级回退链
• 每个MCP服务器都可以独立工作，也可以作为Concilium的一部分工作
• 即插即用：克隆， npm install，添加到 .mcp.json

建筑

┌─────────────────────────────────────────────────────────┐
│                     Claude Code                          │
│                                                          │
│  "Review this code for race conditions"                  │
│                                                          │
│  ┌──────────────┐  ┌──────────────┐                      │
│  │  MCP Call #1  │  │  MCP Call #2  │   (parallel)        │
│  └──────┬───────┘  └──────┬───────┘                      │
│         │                  │                              │
└─────────┼──────────────────┼──────────────────────────────┘
          │                  │
          ▼                  ▼
   ┌──────────────┐   ┌──────────────┐
   │  mcp-openai  │   │  mcp-gemini  │     Primary agents
   │  (codex exec)│   │ (gemini -p)  │
   └──────┬───────┘   └──────┬───────┘
          │                  │
          ▼                  ▼
   ┌──────────────┐   ┌──────────────┐
   │   OpenAI     │   │   Google     │     LLM providers
   │   (OAuth)    │   │   (OAuth)    │
   └──────────────┘   └──────────────┘

   Fallback chain (on quota/error):
   OpenAI → Qwen → DeepSeek
   Gemini → Qwen → DeepSeek

快速入门

1.克隆并安装

git clone https://github.com/spyrae/claude-concilium.git
cd claude-concilium

# Install dependencies for each server
cd servers/mcp-openai && npm install && cd ../..
cd servers/mcp-gemini && npm install && cd ../..
cd servers/mcp-qwen && npm install && cd ../..

# Verify all servers work (no CLI tools required)
node test/smoke-test.mjs

预期产量：

PASS mcp-openai  (Tools: openai_chat, openai_review)
PASS mcp-gemini  (Tools: gemini_chat, gemini_analyze)
PASS mcp-qwen    (Tools: qwen_chat)
All tests passed.

2.设置提供者

至少选择2个提供商：

3.添加到克劳德代码

复制 config/mcp.json.example 并更新路径：

# Edit the example with your actual paths
cp config/mcp.json.example .mcp.json
# Update "/path/to/claude-concilium" with actual path

或者将服务器单独添加到现有服务器中 .mcp.json:

{
  "mcpServers": {
    "mcp-openai": {
      "type": "stdio",
      "command": "node",
      "args": ["/absolute/path/to/servers/mcp-openai/server.js"],
      "env": {
        "CODEX_HOME": "~/.codex-minimal"
      }
    },
    "mcp-gemini": {
      "type": "stdio",
      "command": "node",
      "args": ["/absolute/path/to/servers/mcp-gemini/server.js"]
    }
  }
}

4.安装技能（可选）

将Concilium技能复制到您的Claude Code命令中：

cp skill/ai-concilium.md ~/.claude/commands/ai-concilium.md

现在使用 /ai-concilium 在Claude Code中触发多代理协商。

MCP服务器

每个服务器都可以独立使用——你不需要所有服务器。

深度求索 使用现有 deepseek-mcp-server npm包——不需要自定义服务器。

运作原理

咨询流程

1. 制定 --简洁地描述问题（不超过500个字符）
2. 并行发送 --OpenAI+Gemini得到相同的提示
3. 处理错误 --如果提供者失败，回退链就会启动（Qwen→ DeepSeek）
4. 合成 --比较回应，达成共识
5. 迭代 （可选）--通过后续问题解决分歧
6. 决定 --应用合成溶液

错误检测

所有服务器都检测特定于提供程序的错误并返回结构化响应：

后备链

Primary:   OpenAI ──────────────► Response
           (QUOTA_EXCEEDED?)
                    │
Fallback 1: Qwen ──┴────────────► Response
           (timeout?)
                    │
Fallback 2: DeepSeek ───────────► Response (always available)

何时使用Concilium

码头工人

在容器中运行任何服务器：

# Build
docker build -t claude-concilium .

# Run a specific server (mcp-openai | mcp-gemini | mcp-qwen)
docker run -i --rm -e SERVER=mcp-openai claude-concilium
docker run -i --rm -e SERVER=mcp-gemini claude-concilium

注： 服务器包装CLI工具(codex, gemini, qwen)这需要本地身份验证。运行时装载您的身份验证凭据：

# OpenAI (Codex)
docker run -i --rm -e SERVER=mcp-openai \
  -v ~/.codex:/root/.codex:ro \
  claude-concilium

# Gemini
docker run -i --rm -e SERVER=mcp-gemini \
  -v ~/.config/gemini:/root/.config/gemini:ro \
  claude-concilium

定制

看 docs/customization.md 用于：

• 添加自己的LLM提供者
• 修改回退链
• MCP服务器模板
• 自定义提示策略

文档

• 建筑 --流程图、错误处理、设计决策
• OpenAI设置 --Codex CLI、ChatGPT Plus、最小配置
• Gemini设置 --gemini cli、谷歌OAuth
• Qwen设置 --Qwen CLI、DashScope
• DeepSeek设置 -API密钥，npm包
• 定制 --添加自己的LLM，修改链

更新日志

v2.0.0（2026-03-02）

麦议员问：

• 通过stdin快速交付(-p -)而不是命令参数——对任何内容都是安全的，没有长度限制
• 通过以下方式支持OAuth身份验证类型 QWEN_AUTH_TYPE env变量（例如。， qwen-oauth)
• 新错误检测： AUTH_NOT_CONFIGURED （捕获“未选择身份验证类型”）
• 优雅的关机处理程序（SIGTERM）

mcp openai：

• 默认超时时间从90秒增加到180秒（codex exec在复杂的提示下可能会变慢）

所有服务器：

• 版本升级到2.0.0
• 更新的文档和设置指南

v0.1.0（2025-12-15）

• 初始版本包含3个MCP服务器（OpenAI、Gemini、Qwen）
• 使用回退链的简洁技能
• 烟雾测试套件
• Docker支持

许可证

麻省理工学院