🏛️ Roundtable MCP (roundtable-mcp)

Ролевой гибридный MCP-сервер для оркестрации множества моделей

roundtable-mcp — это открытый MCP-сервер (Model Context Protocol), который оркестрирует группу специализированных ИИ-моделей, объединяя локальные бесплатные модели (через Ollama) с облачными API (Anthropic Claude, Google Gemini, OpenAI, DeepSeek и т.д.).

Вместо голосования за общие ответы, Roundtable назначает каждой модели отдельные экспертные роли (Архитектор, Инженер по внедрению, Специалист по нарративам, Эксперт по рефакторингу систем, Специалист по глубоким рассуждениям) и синтезирует их идеи в единые отчеты консультативного совета.

✨ Ключевые возможности

• Ролевая панель: Каждая модель действует с определенной предметной перспективы, а не предоставляет общие дублирующие ответы.

• Гибридное выполнение: Бесшовное смешивание локальных моделей (Ollama Gemma 4, Qwen Coder, Llama 3) с облачными API (Claude 3.7/4.6, Gemini 3.5, DeepSeek R1, GPT-4o).

• Параллельный разветвитель: run_roundtable опрашивает все активные модели панели параллельно с помощью Promise.allSettled() для быстрого выполнения и высокой отказоустойчивости.

• Управление через конфигурацию: Добавляйте или изменяйте модели в любое время, редактируя config.json без изменения кода.

• Кроссплатформенный MCP: Нативная совместимость с Claude Code, Cursor, Windsurf, Antigravity, OpenCode и VS Code.

Related MCP server: Councly MCP Server

📦 Быстрый старт

1. Установка

git clone https://github.com/YOUR_USERNAME/roundtable-mcp.git
cd roundtable-mcp
npm install
npm run build

2. Конфигурация

Скопируйте config.example.json в config.json:

cp config.example.json config.json

Установите необходимые переменные окружения для облачных моделей:

export ANTHROPIC_API_KEY="sk-ant-..."
export DEEPSEEK_API_KEY="sk-..."
export OPENAI_API_KEY="sk-..."
export GEMINI_API_KEY="AIzaSy..."

🛠️ Справочник инструментов MCP

📋 Каталог предустановленных ролей (role_preset)

Вместо написания пользовательских описаний ролей вы можете использовать встроенные предустановленные ключи в config.json через "role_preset":

• qa_tester: Специалист по тестированию QA и граничных случаев

• cicd_engineer: Инженер CI/CD

• security_auditor: Аудитор безопасности

• database_architect: Архитектор баз данных

• architect: Ведущий системный архитектор

• performance_tuner: Специалист по низкоуровневой производительности и рефакторингу

• frontend_ux: Специалист по фронтенду и UI/UX доступности

• game_engineer: Инженер игровых движков и механик

• tech_writer: Технический писатель и автор API-документации

{
  "id": "claude-qa",
  "name": "Claude Sonnet 4.6",
  "role_preset": "qa_tester",
  "provider": "anthropic",
  "model": "claude-3-7-sonnet-20250219",
  "enabled": true
}

🎯 Назначение специализированных навыков моделям (skill)

Да! Вы можете назначать конкретные руководства по предметным навыкам, стандарты кодирования или контрольные списки каждой модели в зависимости от ее роли.

Используйте свойство "skill" (или "skill_prompt") в config.json, чтобы внедрить настраиваемые инструкции в системный запрос этой конкретной модели:

{
  "id": "gemma-godot",
  "name": "Gemma 4 (Local)",
  "role": "GDScript Implementation Specialist",
  "skill": "Follow Godot 4 GDScript standards: strict static typing, signal decoupling, and node path verification.",
  "provider": "ollama",
  "endpoint": "http://localhost:11434/api/generate",
  "model": "gemma4-26b-128k:latest",
  "enabled": true
}

📓 Интеграция с хранилищем Obsidian (долговременная память)

roundtable-mcp подключается напрямую к вашему локальному хранилищу Obsidian, чтобы автоматически записывать заметки сессий и обеспечивать постоянную память между сессиями — даже для локальных моделей с меньшими окнами контекста!

Конфигурация в config.json:

{
  "obsidian": {
    "enabled": true,
    "vault_path": "C:/Users/yourname/Documents/ObsidianVault",
    "folder": "Roundtable/Sessions",
    "auto_save": true,
    "max_context_notes": 3
  }
}

• Автоматическая запись сессий: Каждая сессия run_roundtable форматируется как чистая заметка Markdown с метаданными, датой и тегами (#roundtable #council #gemma #claude).

• Извлечение памяти: Используйте search_obsidian_memory для получения компактных фрагментов прошлых заметок, чтобы модели с меньшими окнами контекста оставались информированными без переполнения контекста!

🔧 Интеграция с платформами ИИ-кодирования

Claude Code / Claude Desktop / Antigravity / OpenCode

Добавьте roundtable-mcp в ваш конфигурационный файл MCP (раздел mcpServers):

{
  "mcpServers": {
    "roundtable": {
      "command": "node",
      "args": ["/path/to/roundtable-mcp/dist/index.js"],
      "env": {
        "ANTHROPIC_API_KEY": "sk-ant-...",
        "DEEPSEEK_API_KEY": "sk-...",
        "OPENAI_API_KEY": "sk-...",
        "GEMINI_API_KEY": "AIzaSy..."
      }
    }
  }
}

⚙️ Добавление новых моделей в config.json

Вы можете легко добавить любого провайдера, совместимого с OpenAI (DeepSeek, Groq, Together AI, Mistral, LM Studio, vLLM):

{
  "id": "qwen-coder-local",
  "name": "Qwen 2.5 Coder (Local)",
  "role": "Low-Level Shader & GPU Optimization Specialist",
  "provider": "ollama",
  "endpoint": "http://localhost:11434/api/generate",
  "model": "qwen2.5-coder:32b",
  "enabled": true
}

💡 Пример полностью бесплатного многомодельного стека

Вы можете запустить полную многомодельную конфигурацию Roundtable полностью бесплатно, объединив локальные модели Ollama с бесплатными уровнями облачных API (GitHub Models, Google AI Studio, Groq):

{
  "models": [
    {
      "id": "gpt4o-free",
      "name": "GPT-4o (GitHub Free)",
      "role": "Systems Performance & Refactoring Specialist",
      "provider": "openai-compatible",
      "endpoint": "https://models.github.ai/inference/chat/completions",
      "model": "gpt-4o",
      "api_key_env": "GITHUB_TOKEN",
      "enabled": true
    },
    {
      "id": "gemini-free",
      "name": "Gemini 2.5 Flash (Google Free)",
      "role": "Lead Architect & Synthesizer",
      "provider": "google",
      "model": "gemini-2.5-flash",
      "api_key_env": "GEMINI_API_KEY",
      "enabled": true
    },
    {
      "id": "gemma-local",
      "name": "Gemma 4 (Local Ollama)",
      "role": "Primary Implementation Engineer",
      "provider": "ollama",
      "endpoint": "http://localhost:11434/api/generate",
      "model": "gemma4-26b-128k:latest",
      "enabled": true
    },
    {
      "id": "deepseek-free",
      "name": "DeepSeek R1 (Groq Free)",
      "role": "Deep Reasoning & Math Specialist",
      "provider": "openai-compatible",
      "endpoint": "https://api.groq.com/openai/v1/chat/completions",
      "model": "deepseek-r1-distill-llama-70b",
      "api_key_env": "GROQ_API_KEY",
      "enabled": true
    }
  ]
}

📄 Лицензия

Лицензия MIT. Можете свободно использовать, изменять и распространять!