AI导哈

多AI咨询框架

Claude Concilium是一个基于MCP协议的多AI代理并行咨询框架，为Claude Code提供来自不同LLM（如OpenAI、Gemini等）的并行意见咨询和错误检测回退链功能。

  • by spyrae
  • JavaScript
  • 本地部署
  • 14 星标
  • 更新于
在 GitHub 查看 spyrae/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个提供商：

提供者 身份验证 免费层 设置
开放人工智能 codex login （OAuth） ChatGPT Plus每周积分 安装指南
双子座 谷歌OAuth 每天1000次请求 安装指南
通义 OAuth或API密钥 不同 安装指南
深度求索 API密钥 按次付费（便宜） 安装指南

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服务器

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

服务器 CLI工具 身份验证 工具
mcp openai codex OAuth（ChatGPT Plus） openai_chat, openai_review
mcp双子座 gemini 谷歌OAuth gemini_chat, gemini_analyze
mcp qwen qwen OAuth/API密钥 qwen_chat

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

运作原理

咨询流程

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

错误检测

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

错误类型 含义 操作
QUOTA_EXCEEDED 达到利率/信用额度 使用回退提供程序
AUTH_EXPIRED / AUTH_REQUIRED 令牌需要刷新 重新验证CLI
AUTH_NOT_CONFIGURED Qwen身份验证类型未设置 已设置 QWEN_AUTH_TYPE 有人是。
MODEL_NOT_SUPPORTED 计划中没有模型 使用默认模型
超时 进程挂起 自动终止，使用回退

后备链

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

何时使用Concilium

场景 推荐代理
代码审查 OpenAI+Gemini（并行）
架构决策 OpenAI+Gemini→ 如果不同意，则迭代
卡住的bug（3次以上尝试） 所有可用的代理
性能优化 Gemini（1M上下文）+OpenAI
安全审查 OpenAI+GGemini+手动验证

码头工人

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

# 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服务器模板
  • 自定义提示策略

文档

更新日志

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支持

许可证

麻省理工学院

相关 MCP