This server integrates with OpenAI via the Codex CLI, enabling general chat interactions and automated code reviews as part of a multi-agent consultation workflow.

• openai_chat: Send arbitrary text prompts to OpenAI with configurable working directory (cwd), model override, and timeout (default 90s). Returns structured error responses for quota limits (e.g., QUOTA_EXCEEDED), enabling fallback to other providers.

• openai_review: Perform automated code reviews on Git repositories with flexible targeting:

  • Review uncommitted changes (default)

  • Review changes against a specific base branch

  • Review a specific commit by SHA

  • Provide custom review instructions (e.g., "Focus on error handling and race conditions")

  • Configurable timeout (default 120s) and working directory

• Multi-agent use: Works alongside other LLM servers (Gemini, Qwen) within the Claude Concilium framework for diverse, multi-perspective AI consultations, or operates standalone as an MCP server.

Enables interaction with Google's Gemini models using Google OAuth to provide chat and analysis tools as part of a parallel consultation workflow.

Integrates OpenAI models via the Codex CLI to perform code reviews and chat consultations using OAuth-authenticated sessions.

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

┌─────────────────────────────────────────────────────────┐
│ 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

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.

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

{
 "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"]
 }
 }
}

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

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

# 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

# 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