AI Consensus MCP

AI Consensus MCP Server

Birden fazla AI'dan (Gemini, Codex ve Copilot) paralel yanıtlar alarak konsensüs sağlayan Model Context Protocol (MCP) sunucusu.

Özellikler

• FastMCP 3.0.0b1 altyapısı ile modern MCP desteği
• Asenkron paralel sorgulama - Gemini, Codex ve Copilot'a eş zamanlı istek
• 18 MCP aracı - Tekil sorgular, konsensüs, council pipeline ve multi-agent orchestration
• Modüler yapı - Providers, tools, models ve utils ayrımı
• Pydantic modelleri ile yapılandırılmış çıktılar
• Context logging ve ilerleme raporlama

Ön Koşullar

Kurulum

Bağımlılıkları Yükle

pip install "fastmcp>=3.0.0b1" pydantic

Claude Code'a Ekle

claude mcp add ai-consensus -- python3 /path/to/ai-consensus-mcp/server.py

Doğrulama

claude mcp list

Yapılandırma

Ortam değişkenleri ile yapılandırma:

Araçlar

Tekil Sorgular

Konsensüs

LLM Council Pipeline

karpathy/llm-council'dan ilham alan 3 aşamalı pipeline:

3 Aşama:

1. Stage 1 - İlk Görüşler: Gemini, Codex ve Copilot'a paralel sorgu
2. Stage 2 - Peer Review: Her model, diğer modellerin yanıtlarını anonim olarak değerlendirir
3. Stage 3 - Başkan Sentezi: Seçilen başkan model (varsayılan: Gemini) tüm yanıtları + değerlendirmeleri alarak nihai sentez üretir

Multi-Agent Orchestration

Slash Commands

Claude Code içinden slash command olarak kullanım:

MCP İstemci Entegrasyonu

Claude Code

claude mcp add ai-consensus -- python3 /absolute/path/to/server.py

Claude Desktop

~/.config/claude/claude_desktop_config.json dosyasına ekleyin:

{
  "mcpServers": {
    "ai-consensus": {
      "command": "python3",
      "args": ["/absolute/path/to/ai-consensus-mcp/server.py"],
      "env": {
        "GEMINI_DEFAULT_MODEL": "gemini-2.0-flash"
      }
    }
  }
}

Proje Yapısı

ai-consensus-mcp/
├── server.py              # Ana MCP sunucusu
├── config.py              # Ortam değişkenleri yapılandırması
├── providers/
│   ├── __init__.py
│   ├── gemini.py          # Gemini CLI entegrasyonu
│   ├── codex.py           # Codex CLI entegrasyonu
│   ├── copilot.py         # Copilot CLI entegrasyonu
│   └── subprocess_runner.py # Subprocess yönetimi
├── tools/
│   ├── __init__.py
│   ├── single.py          # ask_gemini, ask_codex, ask_copilot araçları
│   ├── consensus.py       # consensus, synthesis, elicitation araçları
│   ├── council.py         # 3 aşamalı LLM Council pipeline
│   └── orchestration.py   # Multi-agent orchestration araçları
├── models/
│   ├── __init__.py
│   ├── responses.py       # AIResponse, ConsensusResult, SynthesisResult
│   ├── council.py         # PeerReview, CouncilResult
│   └── orchestration.py   # Agent/task modelleri
├── agents/
│   ├── __init__.py
│   ├── base.py            # BaseAgent soyut sınıfı
│   ├── gemini_agent.py    # Gemini worker agent
│   ├── codex_agent.py     # Codex worker agent
│   ├── copilot_agent.py   # Copilot worker agent
│   └── registry.py        # Agent registry
├── skills/
│   ├── consensus/         # /consensus slash command
│   ├── consensus-synthesize/ # /consensus-synthesize slash command
│   ├── council/           # /council slash command
│   └── orchestrate/       # /orchestrate slash command
└── utils/
    ├── __init__.py
    ├── context_helpers.py # Context logging yardımcıları
    └── state.py           # Session state ve cache yönetimi

Geliştirme

Sunucuyu Test Et

fastmcp inspect server.py

MCP Inspector ile Debug

npx @anthropics/inspector python3 server.py

Mimari

┌────────────────────────────────────────────────────────────┐
│                      MCP İstemci                           │
│              (Claude Code / Claude Desktop)                │
└─────────────────────────┬──────────────────────────────────┘
                          │ MCP Protocol (stdio)
┌─────────────────────────▼──────────────────────────────────┐
│                  AI Consensus Server                       │
│                    (FastMCP 3.0)                           │
├────────────────────────────────────────────────────────────┤
│  Tools Layer                                               │
│  ┌──────────────┐  ┌──────────────────┐  ┌─────────────┐ │
│  │ single.py    │  │ consensus.py     │  │ council.py  │ │
│  │ - ask_gemini │  │ - consensus      │  │ - council   │ │
│  │ - ask_codex  │  │ - synthesis      │  │  (3-stage)  │ │
│  │ - ask_copilot│  │ - elicitation    │  └─────────────┘ │
│  └──────────────┘  └──────────────────┘                   │
│  ┌─────────────────────────────────────────────────────┐  │
│  │ orchestration.py                                     │  │
│  │ - handoff, assign, messaging, task management        │  │
│  └─────────────────────────────────────────────────────┘  │
├────────────────────────────────────────────────────────────┤
│  Providers Layer (asyncio.gather ile paralel çalışır)     │
│  ┌────────────────┐  ┌────────────────┐  ┌─────────────┐ │
│  │ gemini.py      │  │ codex.py       │  │ copilot.py  │ │
│  │ subprocess→CLI │  │ subprocess→CLI │  │ subprocess  │ │
│  └───────┬────────┘  └───────┬────────┘  │  → CLI      │ │
└──────────┼───────────────────┼───────────┴──┬──────────┘─┘
           │                   │              │
           ▼                   ▼              ▼
    ┌─────────────┐     ┌─────────────┐  ┌─────────────┐
    │ Gemini CLI  │     │ Codex CLI   │  │ Copilot CLI │
    │ (gemini)    │     │ (codex)     │  │ (copilot)   │
    └─────────────┘     └─────────────┘  └─────────────┘

Lisans

MIT