Brainstorm

Debates de IA de múltiples rondas entre GPT, DeepSeek, Groq y Claude: todos los modelos argumentan, critican y sintetizan dentro de tu asistente de codificación.

Documentación

brainstorm-mcp

npm npm downloads license IdeaCred Product Hunt

Haz una pregunta de diseño a un modelo y obtendrás una respuesta segura, sin señal sobre qué partes le generan dudas. Pregunta a tres y el desacuerdo es la señal.

brainstorm-mcp ejecuta debates de múltiples rondas entre GPT, Gemini, DeepSeek, Claude y modelos locales de Ollama desde tu editor: se ven y critican las respuestas de los demás a lo largo de las rondas, y luego obtienes una síntesis de 3 viñetas: recomendación, compensaciones clave y el desacuerdo más fuerte. También incluye modo rápido instantáneo, revisión de código multi-modelo con veredictos y estilos red-team/socrático. El modo alojado no requiere claves API.

No confíes en una sola IA. Haz que discutan.

Inicio rápido (60 segundos)

claude mcp add brainstorm -- npx -y brainstorm-mcp

Luego pregúntale a Claude: "Brainstorm usando opus, sonnet y haiku sobre si deberíamos usar GraphQL o REST."

Eso se ejecuta en modo alojado: sin claves API, sin cuentas de proveedor. El debate utiliza los modelos ya disponibles en tu entorno y obtienes la síntesis de 3 viñetas al final.

brainstorm-mcp — Claude Opus vs GPT-5.4 vs DeepSeek debating

Demo

Watch the demo

Haz clic para ver: 3 modelos debaten, se interrogan y producen un veredicto estructurado, todo dentro de Claude Code.

Características

  • Modo alojado — No se necesitan claves API. Utiliza modelos en tu entorno (Claude Opus/Sonnet/Haiku) mediante subagentes
  • Modo API — Llamadas directas a la API del modelo con ejecución paralela en OpenAI, Gemini, DeepSeek, Groq, Ollama
  • Modo CLI — Debate a través de las CLI de agentes que ya tienes (claude, codex y más) para que los debates se ejecuten con tu suscripción en lugar de créditos de API
  • brainstorm_quick — Perspectivas instantáneas de múltiples modelos en menos de 10 segundos
  • brainstorm_review — Revisión de código multi-modelo con hallazgos estructurados, calificaciones de severidad y veredictos
  • Estilos de debate — Libre, red-team (adversarial) y socrático (preguntas de sondeo)
  • Inyección de contexto — Fundamenta los debates en código real, diffs o documentos de arquitectura
  • Síntesis de veredictos en 3 viñetas — Recomendación, compensaciones clave, desacuerdo más fuerte
  • Claude como participante — Claude debate junto a modelos externos con contexto completo de conversación
  • Debates de múltiples rondas — Los modelos ven y critican las respuestas de los demás a lo largo de las rondas
  • Ejecución paralela — Todos los modelos responden simultáneamente dentro de cada ronda
  • Resiliente — Que un modelo falle no aborta el debate
  • Multiplataforma — Funciona en macOS, Windows y Linux

Instalación

El comando de una línea bajo Inicio rápido es suficiente para el modo alojado. Agrega claves de proveedor para incorporar GPT, Gemini, DeepSeek, Groq u Ollama al debate; la configuración por cliente se detalla a continuación.

Claude Code

Agrega a tu .mcp.json del proyecto:

{
  "mcpServers": {
    "brainstorm": {
      "command": "npx",
      "args": ["-y", "brainstorm-mcp"],
      "env": {
        "OPENAI_API_KEY": "sk-...",
        "GEMINI_API_KEY": "AIza...",
        "DEEPSEEK_API_KEY": "sk-..."
      }
    }
  }
}

Claude Desktop

Agrega a claude_desktop_config.json:

{
  "mcpServers": {
    "brainstorm": {
      "command": "npx",
      "args": ["-y", "brainstorm-mcp"],
      "env": {
        "OPENAI_API_KEY": "sk-...",
        "DEEPSEEK_API_KEY": "sk-..."
      }
    }
  }
}

Instalación manual

npm install -g brainstorm-mcp
brainstorm-mcp

El modo alojado no requiere claves API: solo instala y listo. El host (Claude Code) ejecuta los prompts usando su propio acceso a modelos.

Configuración

Opción 1: Variables de entorno (la más simple)

OPENAI_API_KEY=sk-...
GEMINI_API_KEY=AIza...
DEEPSEEK_API_KEY=sk-...

Opción 2: Archivo de configuración (control total)

Establece BRAINSTORM_CONFIG para apuntar a una configuración JSON:

{
  "providers": {
    "openai": { "model": "gpt-5.4", "apiKeyEnv": "OPENAI_API_KEY" },
    "gemini": { "model": "gemini-2.5-flash", "apiKeyEnv": "GEMINI_API_KEY" },
    "deepseek": { "model": "deepseek-chat", "apiKeyEnv": "DEEPSEEK_API_KEY" },
    "ollama": { "model": "llama3.1", "baseURL": "http://localhost:11434/v1" }
  }
}

Los proveedores conocidos (openai, gemini, deepseek, groq, mistral, together, moonshot, minimax, glm, qwen) no necesitan un baseURL.

Cualquier ID de modelo que sirva el proveedor funciona, incluido el GPT-6 de OpenAI (openai:gpt-6-astra) y los modelos de razonamiento gpt-5.x: brainstorm elige la forma de solicitud que cada modelo espera y reintenta con la otra forma si la API la rechaza.

Opción 3: Proveedores CLI (usa una suscripción, no créditos de API)

Si ya pagas por Claude Code, Codex, Gemini CLI y similares, brainstorm puede invocar esas CLI en lugar de comprar créditos de API. Cualquier CLI de agente que se encuentre en tu PATH se registra automáticamente al inicio — no se necesita configuración:

[brainstorm] Detected CLI provider(s) on PATH: claude, codex (subscription-based, no API cost)

Úsalos como cualquier otro proveedor:

{ "topic": "GraphQL vs REST", "models": ["claude:sonnet", "codex:default", "openai:gpt-5.4"] }

Adaptadores integrados:

ProveedorComandoModelo predeterminadoEstado
claudeclaude -psonnetverificado
codexcodex execdefaultverificado
geminigemini -pgemini-2.5-promejor esfuerzo, verificar localmente
cursor-agentcursor-agent -pdefaultmejor esfuerzo
opencodeopencode rundefaultmejor esfuerzo
qwenqwen -pqwen3-coder-plusmejor esfuerzo
kimikimi --printdefaultmejor esfuerzo
droiddroid execdefaultmejor esfuerzo

<provider>:default significa "deja que la CLI use el modelo con el que esté configurada". Las llamadas CLI se ejecutan con herramientas deshabilitadas y un sandbox de solo lectura donde la CLI lo admita: generan texto, no tocan tu repositorio. Las variables de entorno de claves API específicas del proveedor (ANTHROPIC_API_KEY, OPENAI_API_KEY) se eliminan del proceso hijo para que la CLI recurra a tu inicio de sesión de suscripción.

Perillas de entorno:

VariableEfecto
BRAINSTORM_CLI_PROVIDERSauto (predeterminado), off o una lista separada por comas de adaptadores a detectar
BRAINSTORM_PREFER_CLI1 — los debates sin un models explícito usan solo proveedores CLI, omitiendo las API medidas
BRAINSTORM_CLI_TIMEOUT_MSTiempo de espera por llamada para proveedores CLI (predeterminado 300000)

Para fijar un modelo o agregar una CLI que no esté integrada, usa el archivo de configuración:

{
  "providers": {
    "claude": { "type": "cli", "model": "opus" },
    "my-cli": {
      "type": "cli",
      "adapter": "custom",
      "command": "some-agent-cli",
      "args": ["run", "--model", "{{model}}", "--quiet", "{{prompt}}"],
      "promptVia": "arg",
      "model": "some-model"
    }
  }
}

Marcadores de plantilla: {{model}}, {{system}}, {{prompt}}, {{outfile}}. Un marcador solitario que se resuelve a nada se elimina de la línea de comandos junto con la bandera que lo introduce, por lo que ["--model", "{{model}}"] funciona incluso para provider:default. Establece "promptVia": "stdin" para canalizar el prompt en lugar de pasarlo como argumento.

Backends de planes de codificación a través de la CLI de Claude

Moonshot (Kimi), MiniMax y Z.ai (GLM) venden suscripciones de planes de codificación que hablan el API de Anthropic. Apunta el binario claude a uno de ellos y ese proveedor se une al debate con el plan que ya pagas:

{
  "providers": {
    "moonshot": { "type": "cli", "backend": "moonshot", "model": "kimi-k2-thinking" },
    "minimax":  { "type": "cli", "backend": "minimax",  "model": "MiniMax-M2" },
    "glm":      { "type": "cli", "backend": "glm",      "model": "glm-4.6" }
  }
}
BackendEndpointVariable de entorno del token
moonshothttps://api.moonshot.ai/anthropicMOONSHOT_API_KEY
minimaxhttps://api.minimax.io/anthropicMINIMAX_API_KEY
glmhttps://api.z.ai/api/anthropicZAI_API_KEY

El token se lee de tu entorno en el momento de la llamada: el archivo de configuración contiene el nombre de la variable, nunca el secreto. ANTHROPIC_API_KEY se elimina del hijo para que tu cuenta de Anthropic nunca se facture por estos. Cualquier proveedor CLI también acepta un bloque "env" para anular el backend manualmente; un valor de "$NAME" se indirecta a través del entorno del servidor.

Estos proveedores también son accesibles como API medidas simples: moonshot, minimax, glm y qwen tienen URL base conocidas, por lo que MOONSHOT_API_KEY solo es suficiente para registrar moonshot como un proveedor de API.

Herramientas

HerramientaDescripciónAnotación
brainstormDebate de múltiples rondas entre modelos de IA (modo API o alojado)readOnly
brainstorm_quickPerspectivas instantáneas de múltiples modelos — paralelas, sin rondasreadOnly
brainstorm_reviewRevisión de código multi-modelo con hallazgos, severidad, veredictoreadOnly
brainstorm_respondEnvía la respuesta de Claude en una sesión interactivareadOnly
brainstorm_collectEnvía respuestas de modelos en una sesión alojadareadOnly
list_providersMuestra proveedores configurados, estado de claves API y CLI detectadasreadOnly
add_providerAgrega un nuevo proveedor API o CLI en tiempo de ejecuciónno destructiva

Ejemplos de uso

Ejemplo 1: Perspectivas rápidas de múltiples modelos

Prompt: "Usa brainstorm_quick para comparar Redis vs PostgreSQL para almacenamiento de sesiones"

Herramienta llamada: brainstorm_quick

{ "topic": "Redis vs PostgreSQL for session storage in a Node.js app" }

Salida: Cada modelo configurado responde de forma independiente en paralelo. Obtienes una comparación lado a lado en menos de 10 segundos con nombres de modelos, respuestas, tiempos y costo.

Manejo de errores: Si un modelo falla (límite de velocidad, tiempo de espera), la herramienta continúa con los modelos restantes y muestra cuáles fallaron.


Ejemplo 2: Revisión de código multi-modelo

Prompt: "Revisa este diff en busca de problemas de seguridad" (con un git diff pegado)

Herramienta llamada: brainstorm_review

{
  "diff": "diff --git a/src/auth.ts ...",
  "title": "Add JWT authentication middleware",
  "focus": ["security", "correctness"]
}

Salida: Un veredicto estructurado (aprobar / aprobar con advertencias / necesita cambios) con una tabla de hallazgos que muestra severidad, categoría, archivo, números de línea y sugerencias. Incluye análisis de acuerdo entre modelos: los problemas señalados por varios modelos tienen mayor confianza.

Manejo de errores: Si la síntesis falla, las revisiones crudas de los modelos aún se devuelven.


Ejemplo 3: Brainstorm en modo alojado (sin claves API)

Prompt: "Brainstorm usando opus, sonnet y haiku sobre si deberíamos usar GraphQL o REST"

Herramienta llamada: brainstorm

{
  "topic": "GraphQL vs REST for our public API",
  "models": ["opus", "sonnet", "haiku"],
  "mode": "hosted",
  "rounds": 2,
  "style": "redteam"
}

Salida: La herramienta devuelve prompts para cada modelo. El host (Claude Code) genera subagentes con diferentes modelos, recopila respuestas y las retroalimenta a través de brainstorm_collect. Después de todas las rondas, un modelo de síntesis produce un veredicto de 3 viñetas: Recomendación, Compensaciones clave, Desacuerdo más fuerte.

Manejo de errores: Las sesiones expiran después de 10 minutos. Si no se encuentra una sesión, se devuelve un mensaje de error claro con instrucciones para iniciar una nueva.

Cómo funciona

Modo API / CLI

  1. Le pides a Claude que haga un brainstorm sobre un tema
  2. La herramienta envía el tema a todos los proveedores configurados en paralelo — HTTP para proveedores API, un subproceso generado para proveedores CLI
  3. Claude lee sus respuestas y contribuye con su propia perspectiva
  4. Los modelos ven las respuestas de los demás y refinan a lo largo de las rondas
  5. Un sintetizador produce el veredicto final

Modo alojado

  1. Le pides a Claude que haga un brainstorm con modelos específicos (p. ej., opus, sonnet, haiku)
  2. La herramienta devuelve prompts — no se realizan llamadas API
  3. Claude genera subagentes con diferentes modelos para ejecutar los prompts
  4. Las respuestas se recopilan y retroalimentan para la siguiente ronda
  5. Repite hasta la síntesis

Política de privacidad

brainstorm-mcp se ejecuta completamente en tu máquina y no recopila, almacena ni transmite ningún dato personal, telemetría o análisis.

En modo API, los prompts se envían directamente desde tu máquina a los proveedores de modelos que configures (OpenAI, Gemini, DeepSeek, etc.) usando tus propias claves API. En modo CLI, los prompts se pasan a las CLI de agentes instaladas en tu máquina, que hablan con sus propios proveedores bajo tu suscripción existente. En modo alojado, no se realizan llamadas API externas.

Las sesiones de debate se almacenan solo en memoria con un TTL de 10 minutos. No se escribe ningún dato en el disco a menos que guardes explícitamente los resultados.

Política de privacidad completa: PRIVACY.md

Soporte

Desarrollo

git clone https://github.com/spranab/brainstorm-mcp.git
cd brainstorm-mcp
npm install
npm run build
npm start

Proyectos relacionados

Otra infraestructura de agentes del mismo autor, construida para usarse en conjunto:

  • saga-mcp — rastreador de proyectos respaldado por SQLite: una vez que el debate se resuelve, la decisión va a un lugar duradero.
  • yantrikdb-mcp — memoria cognitiva persistente para que el agente recuerde qué decidiste y por qué.
  • swarmcode — canal en tiempo real entre instancias de Claude Code en diferentes máquinas.
  • truenas-mcp — 278 acciones de TrueNAS SCALE detrás de una herramienta jerárquica.
  • mcpier — plano de control MCP autoalojado que mantiene las claves API fuera de tus clientes.

Licencia

MIT