🏛️ Roundtable MCP (roundtable-mcp)

Servidor MCP de Orquestación Multi-Modelo Híbrida Basada en Roles

roundtable-mcp es un servidor de código abierto del Protocolo de Contexto de Modelo (MCP) que orquesta un panel de modelos de IA especializados, combinando modelos locales de costo cero (vía Ollama) con APIs en la nube (Anthropic Claude, Google Gemini, OpenAI, DeepSeek, etc.).

En lugar de votar respuestas genéricas, Roundtable asigna roles de experto distintos a cada modelo (Arquitecto, Ingeniero de Implementación, Especialista en Narrativa, Experto en Refactorización de Sistemas, Especialista en Razonamiento Profundo) y sintetiza sus perspectivas en informes unificados del consejo asesor.

✨ Características Clave

• Panel Basado en Roles: Cada modelo actúa desde una perspectiva de dominio designada en lugar de proporcionar respuestas duplicadas genéricas.

• Ejecución Híbrida: Combina sin problemas modelos locales (Ollama Gemma 4, Qwen Coder, Llama 3) con APIs en la nube (Claude 3.7/4.6, Gemini 3.5, DeepSeek R1, GPT-4o).

• Expansión en Paralelo: run_roundtable consulta todos los modelos del panel activo en paralelo usando Promise.allSettled() para una ejecución rápida y alta tolerancia a fallos.

• Configuración Guiada: Añade o ajusta modelos en cualquier momento editando config.json sin modificar código.

• MCP Multiplataforma: Compatibilidad nativa con Claude Code, Cursor, Windsurf, Antigravity, OpenCode y VS Code.

Related MCP server: Councly MCP Server

📦 Inicio Rápido

1. Instalación

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

2. Configuración

Copia config.example.json a config.json:

cp config.example.json config.json

Establece las variables de entorno necesarias para los modelos en la nube:

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

🛠️ Referencia de Herramientas MCP

📋 Catálogo de Roles Predefinidos (role_preset)

En lugar de escribir descripciones de roles personalizadas, puedes usar claves predefinidas integradas en config.json mediante "role_preset":

• qa_tester: Especialista en Pruebas de QA y Casos Límite

• cicd_engineer: Especialista en DevOps y Tuberías CI/CD

• security_auditor: Auditor de Ciberseguridad y Vulnerabilidades

• database_architect: Arquitecto de Base de Datos y Optimizador de Consultas

• architect: Arquitecto Principal de Sistemas y Orquestador

• performance_tuner: Especialista en Rendimiento de Bajo Nivel y Refactorización

• frontend_ux: Especialista en Frontend y Accesibilidad UI/UX

• game_engineer: Especialista en Motores de Juego y Mecánicas

• tech_writer: Escritor de Documentación Técnica y API

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

🎯 Asignación de Habilidades Especializadas a Modelos (skill)

¡Sí! Puedes asignar directrices de habilidades de dominio específicas, estándares de codificación o listas de verificación a cada modelo según su rol.

Usa la propiedad "skill" (o "skill_prompt") en config.json para inyectar instrucciones personalizadas en el prompt del sistema de ese modelo específico:

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

📓 Integración con Bóveda de Obsidian (Memoria a Largo Plazo)

roundtable-mcp se conecta directamente a tu Bóveda de Obsidian local para registrar automáticamente notas de sesión y proporcionar memoria persistente entre sesiones, ¡incluso para modelos locales con ventanas de contexto más pequeñas!

Configuración en config.json:

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

• Registro Automático de Sesiones: Cada sesión de run_roundtable se formatea como una nota Markdown limpia con metadatos, fecha y etiquetas (#roundtable #council #gemma #claude).

• Recuperación de Memoria: Usa search_obsidian_memory para obtener fragmentos compactos de notas pasadas, ¡para que los modelos con ventanas de contexto más pequeñas se mantengan informados sin desbordamiento de contexto!

🔧 Integración con Plataformas de Codificación de IA

Claude Code / Claude Desktop / Antigravity / OpenCode

Añade roundtable-mcp a tu archivo de configuración MCP (sección 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..."
      }
    }
  }
}

⚙️ Adición de Nuevos Modelos a config.json

Puedes añadir fácilmente cualquier proveedor compatible con 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
}

💡 Ejemplo de Pila Multi-Modelo 100% Gratuita

Puedes ejecutar una configuración completa de Roundtable multi-modelo totalmente gratuita combinando modelos locales de Ollama con niveles gratuitos de API en la nube (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
    }
  ]
}

📄 Licencia

Licencia MIT. Siéntete libre de usar, modificar y distribuir