roundtable-mcp

# Roundtable MCP **Role-Based Multi-Model Orchestration Server** — Turn multiple AI models into a coordinated expert council. [](https://opensource.org/licenses/MIT) [](https://modelcontextprotocol.io) [](https://www.typescriptlang.org/) [](https://nodejs.org/) --- ## 🏛️ What is Roundtable? **Roundtable MCP** is a Model Context Protocol (MCP) server designed for role-based multi-model council orchestration. Instead of asking several models the same question and voting on their answers, Roundtable assigns each model a specialized role, equips them with custom skill guidelines, runs them across a **3-tier priority execution pipeline** (Antigravity CLI, Local Ollama, Cloud APIs), and synthesizes their findings into unified reports automatically persisted to your Obsidian Vault. ``` ┌── Architect (Gemini 3.7 Flash) ────┐ ├── Developer (Gemma 4 Local GPU) ───┤ Prompt ──────────┼── QA Tester (Claude Sonnet 4.6) ───┼──> Synthesis Report └── DevOps (GPT-OSS 120B) ───────────┘ PARALLEL ROUNDTABLE ``` --- ## 💡 Key Capabilities - **👥 Parallel Expert Panels (`roundtable_start`)**: Execute multiple specialized LLMs (Gemini, Claude, Gemma, GPT-OSS) simultaneously for multi-dimensional problem solving. - **⚡ Host Delegation & Exclusion**: Automatically skips spawning redundant background CLI/API subprocesses for the active host model, delegating lead synthesis directly to the live session. - **🌊 Sequential Cascade Relays (`roundtable_cascade`)**: Pipeline tasks across multi-stage handoffs (`Architect` $\rightarrow$ `Developer` $\rightarrow$ `QA` $\rightarrow$ `DevOps`). - **🛡️ 3-Tier Execution Pipeline**: Prioritizes zero-config Antigravity CLI (leveraging your subscription Google OAuth), falls back to Local Ollama GPU, and routes to direct Cloud APIs when needed. - **🎯 Dynamic Roles & Skills Engine (`roundtable_roles`, `roundtable_assign_role`)**: Assign models distinct roles (`ROLES.md`) with dynamic `.skill` and `SKILL.md` rules. - **📓 Persistent Obsidian Memory & Graph Hubs (`roundtable_save`, `roundtable_search`)**: Automatically log sessions, search past memories, and ingest documents/folders with 30-minute auto-save throttling and automatic Graph View clustering. - **🔍 Honest Execution (Zero Faked Personas)**: No single-model roleplay simulations. If a model is offline or out of quota, Roundtable honestly reports the connectivity diagnostic. --- ## 🛠️ Official Tools Catalog | Official Tool Name | Mode / Category | Description | |:---|:---|:---| | **`roundtable_start`** | 👥 **Parallel Council** | Starts a multi-model council advisory discussion across registered expert models. | | **`roundtable_cascade`** | 🌊 **Sequential Relay** | Runs multi-stage sequential relay (`Architect ➔ Dev ➔ QA ➔ DevOps`). | | **`roundtable_route`** | 🎯 **Single Router** | Routes a specialized prompt to a single target model or role. | | **`roundtable_roles`** | 📋 **Project Roles** | Displays active project model roles, aliases, and `ROLES.md` priority sources. | | **`roundtable_assign_role`** | ✍️ **Assign Role** | Dynamically assigns a custom role to a model & persists in `ROLES.md`. | | **`roundtable_assign_skill`** | 🧠 **Assign Skill** | Associates a `.skill` file or skill guideline to a specific model. | | **`roundtable_models`** | 🏛️ **List Experts** | Lists all registered expert models, their roles, and provider status. | | **`roundtable_presets`** | 📋 **Preset Catalog** | Lists all built-in expert roles (`qa_tester`, `cicd_engineer`, `security_auditor`, etc.). | | **`roundtable_search`** | 📓 **Vault Search** | Searches past session notes in Obsidian memory. | | **`roundtable_save`** | ✍️ **Save Vault Note** | Saves custom notes or ingests files/folders into your Obsidian Vault. | | **`roundtable_read`** | 📖 **Read Vault Note** | Reads full markdown content of an Obsidian note. | | **`roundtable_help`** | ❓ **Help & Cheatsheet** | Displays the complete quickstart cheatsheet directly in chat. | --- ## 🚀 Quick Start ### 1. Clone & Build ```bash git clone https://github.com/hardc0l2e/roundtable-mcp.git cd roundtable-mcp npm install npm run build ``` ### 2. Configure Models (`config.json`) ```json { "models": [ { "id": "gemini-flash", "name": "Gemini 3.7 Flash (Antigravity)", "role_preset": "architect", "aliases": ["gemini", "flash", "lead", "architect"], "provider": "antigravity-cli", "model": "gemini-3.7-flash-medium", "enabled": true }, { "id": "claude-sonnet", "name": "Claude Sonnet 4.6 (Antigravity)", "role_preset": "qa_tester", "aliases": ["claude", "sonnet", "qa"], "provider": "antigravity-cli", "model": "claude-sonnet-4-6", "enabled": true }, { "id": "gpt-oss", "name": "GPT-OSS 120B (Antigravity)", "role_preset": "cicd_engineer", "aliases": ["gpt", "gpt-oss", "devops"], "provider": "antigravity-cli", "model": "gpt-oss-120b-medium", "enabled": true }, { "id": "gemma-local", "name": "Gemma4 26B 128k (Local GPU)", "role": "Primary Implementation Engineer", "aliases": ["gemma", "gemma4", "local", "coder"], "provider": "ollama", "endpoint": "http://localhost:11434/api/generate", "model": "gemma4-26b-128k:latest", "enabled": true } ], "obsidian": { "enabled": true, "vault_path": "C:/Users/username/Documents/Obsidian Vault", "folder": "roundtable-mcp/Sessions", "auto_save": true } } ``` *For detailed provider settings and environment variables, see [docs/configuration.md](docs/configuration.md).* --- ## 🏗️ Architecture & Execution Pipeline Roundtable MCP resolves every model query through a resilient 3-tier priority execution pipeline: ```mermaid flowchart TD Client["MCP Client Host (OpenCode / Antigravity / Codex)"] -->|"JSON-RPC (STDIO)"| Server["Roundtable Server (dist/index.js)"] subgraph CoreManagers["Core Managers"] Server --> Roles["RolesManager (ROLES.md Override)"] Server --> Skills["SkillResolver (.skill / SKILL.md)"] Server --> Obsidian["ObsidianManager (Vault Search & Ingestion)"] end Roles --> Pipeline["Provider Routing Engine"] Skills --> Pipeline Obsidian --> Pipeline subgraph ExecutionPipeline["Execution Pipeline"] Pipeline --> Tier1["Tier 1: agy.exe (Google OAuth)"] Tier1 -.-> Gemini["Gemini / Claude / GPT-OSS"] Pipeline --> Tier2["Tier 2: Local GPU (llama.cpp / Ollama)"] Tier2 -.-> Gemma["Qwen / Gemma 4 / GPT-OSS"] Pipeline --> Tier3["Tier 3: Cloud APIs (OpenCode Zen / OpenRouter / Direct)"] Tier3 -.-> OpenRouter["Direct REST API Providers"] end Tier1 --> ErrorCheck["Fault Isolation & Root Cause Extraction"] Tier2 --> ErrorCheck Tier3 --> ErrorCheck ErrorCheck --> Output["Council Synthesis & Obsidian Vault Auto-Save"] ``` --- ## 🔌 Client Integration Setup ### OpenCode (`~/.config/opencode/opencode.jsonc`) ```jsonc { "mcp": { "roundtable": { "type": "local", "command": [ "node", "C:\\projects\\roundtable-mcp\\dist\\index.js", "--config", "C:\\projects\\roundtable-mcp\\config.json" ] } } } ``` ### Google Antigravity (`~/.gemini/config/mcp_config.json`) ```json { "mcpServers": { "roundtable-mcp": { "command": "node", "args": ["c:/projects/roundtable-mcp/dist/index.js"], "env": { "ROUNDTABLE_CONFIG_PATH": "c:/projects/roundtable-mcp/config.json" } } } } ``` --- ## 💡 Practical Examples 1. **Run a Parallel Council Discussion**: ```json roundtable_start(prompt: "Design high-concurrency authentication microservice for 1M DAU") ``` 2. **Run a Multi-Stage Feature Cascade**: ```json roundtable_cascade(prompt: "Build JWT Authentication Endpoint", pipeline: ["architect", "coder", "qa_tester", "cicd_engineer"]) ``` 3. **Ingest Documentation to Obsidian Graph Hub**: ```json roundtable_save(source_path: "docs/architecture.md", target_folder: "roundtable-mcp", target_base: "ROUNDTABLE MCP", tags: ["architecture", "roundtable"]) ``` 4. **Search Past Decision Memory**: ```json roundtable_search(query: "circuit breakers") ``` --- ## 📄 License This project is licensed under the [MIT License](LICENSE).