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

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

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

npm install -g brainstorm-mcp
brainstorm-mcp

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

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

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

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

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

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

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

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

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

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

Wait — I accidentally put "https://long.gov/spranab/brainstorm-mcp"? That is a mistake — must keep URL verbatim: https://github.com/spranab/brainstorm-mcp. Also I see a few slips:

- "привключить" -> "добавить/пригласить".
- "дебатывал" -> "дебаты".
- "Сократовский" vs "сократовский" — fine.
- "уточняющие" maybe "пробuющие".
- "без сигнала о том, какие её части вызывают у неё сомнения" — mistype "вызывает" vs "вызывают": "какие её части вызывают".
- " если synтез is error" -> better: "Если синтез дала сбой,..." 
- "Например, падение".
- "non-destructive" — keep.
- "слово точность" — fine.
- "的" no.

Also I used two close dashes "—" for "0" — okay.

We must produce a clean final answer with corrected text. Let me carefully re-run whole output and fix errors, including:

1. The sentence "Для hosted-режима не требуется ни одного API-ключа." — OK.

2. Feature list bullet fix.

3. The phrase under "Клиент "сессий" etc. We'll fix.

Make sure the link "Development" no other issue.

Also "ы" etc.

Let me produce clean polished final.

Double-check token preservation:

- All `GXP1` to `GXP14` present. In my draft, check: GXP1, GXP2, GXP3, GXP4, GXP5, GXP6, GXP7, GXP8, GXP9 (with code block), GXP10, GXP11, GXP12, GXP13, GXP14. Yes.

- "Watch the demo" — I wrote `[![Watch the demo](...)](...)` — keep English? At first I decided might translate, but now I kept English. Fine because alt. 

- "Claude Opus/Sonnet/Haiku" etc.

- The table "Provider" as "Провайдер" — fine.

- "http" URLs.

Let's refine the translation with consistent vocabulary:

- "hosted-режим" continuous.
- "мультимодельный" vs "мультимодельный" — "multi-model" — "мультимодельный" (with y). Good.

Now, the "Support" link: should be exactly <https://github.com/spranab/brainstorm-mcp> — my draft had a placeholder "long.zero"— must correct to "com/spranab/brainstorm-mcp".

Also, in the "HOSTED" heading Example 3: I put "Хостед без API-ключей" — correct "hosted". In the step "Хост-режим" — the phrase "Хостед-режим" (translate "hosted" uses French "хостед" or "hosted"). Earlier I used "hosted-режим". In Russian technical literature, "hosted режим" might stand. Use "hosted-режим" consistently in headings and features. In "Example 3": "### Пример 3: Brainstorm в hosted-режиме (без API-ключей)".

- "Режимы API/CLI" — "### Режимы API и CLI". Good.

- Important: In "Способы" features bullet: "мультимодельное код-ревью" — fine.

- Table description "brainstorm" — in Tools table: "Multi-round debate between AI models (API or hosted mode)" — okay.

- In "CLI braces" description: "stand alone ... read-only sandbox and tools disabled ..." — keep as source: "инструменты отключены и песочница используется для CLI как поддерж." Fine.

Now the sentence: "SDK and description: "Any CLI provider also accepts an `"env"` block to override the backend; a value of "`$NAME`"..." — translated above.

Created code block in GXP9 — In the original, GXP9 is a placeholder line. The following paragraph continues. We do not add a code fence around GXP9; keep as `GXP9` alone. Yes.

Also from the "Кодинговые планы не только" paragraph: "The known providers list" — fine.

Now perhaps changed `— recommendation, key tradeoffs, strongest disagreement` to Russian in first paragraph; and in features keep English label. That's okay to present.

Some more refinements:

- "It uses models in your environment — ...". */
- "вместе с флагом, который его объявляет" — "с флагом, который его вводит" better.
- "своим установкам" — "так,как настроен".

- The phrase in Option 3: "If you already pay for Claude Code, Codex, Gemini CLI, and friends" — "and others."

- "Other agent infrastructure"— "агентную инфраструктуру".

Now, let's produce the final output, clean and with correct spacing.

But one more: The plugin label "brainstorm-mcp runs multi-round debates between GPT..." — "phrase from your editor" — before it reads "multi-round" — translate "многораундовые".

"then you get a 3-bullet synthesis — recommendation, key tradeoffs, strongest disagreement." — I translate in text.

"Also does instant quick mode, ..." — "кроме того, есть мгновенный быстрый режим".

Final check: Need to include the horizontal rule after Example 1, Example 2 (the "***" with blank lines). Done.

The source line "> Click to watch: ..." done.

Ok, final.<!-- mcp-name: io.github.spranab/brainstorm-mcp -->

# brainstorm-mcp

[![npm](https://img.shields.io/npm/v/brainstorm-mcp)](https://www.npmjs.com/package/brainstorm-mcp)
[![npm downloads](https://img.shields.io/npm/dm/brainstorm-mcp)](https://www.npmjs.com/package/brainstorm-mcp)
[![IdeaCred](https://ideacred.com/api/badge/spranab/brainstorm-mcp)](https://ideacred.com/profile/spranab)
[![Product Hunt](https://img.shields.io/badge/Product%20Hunt-Launch-orange)](https://www.producthunt.com/products/brainstorm-3?launch=brainstorm-4)

Задайте один вопрос по дизайну одной модели — и вы получите один уверенный ответ, без сигнала о том, в каких местах сама модель не уверена. Спросите три модели — и тогда сигналом становятся разногласия между ними.

brainstorm-mcp запускает многораундовые дебаты между GPT, Gemini, DeepSeek, Claude и локальными моделями Ollama прямо из вашего редактора: они видят и критикуют ответы друг друга между раундами, а затем вы получаете синтез из трёх пунктов — рекомендацию, ключевые компромиссы и самый острый конфликт. Также есть мгновенный быстрый режим, мультимодельное код-ревью с вердиктами и стили red-team/Socratic. Hosted-режим не требует API-ключей.

**Не доверяйте одной модели. Заставьте их спорить.**

<p align="center">
  <img src="docs/hero.png" alt="brainstorm-mcp — Claude Opus vs GPT-5.4 vs DeepSeek debating" width="800" />
</p>

### Демо

[![Watch the demo](https://img.youtube.com/vi/L5kli5_fgkI/maxresdefault.jpg)](https://youtu.be/L5kli5_fgkI)

> Нажмите, чтобы посмотреть: три модели ведут дебаты, перекрёстно допрашивают друг друга и выдают структурированный вердикт — всё внутри Claude Code.

## Возможности

* **Hosted-режим** — API-ключи не нужны. Используются модели вашего окружения (Claude Opus/Sonnet/Haiku) через субагентов
* **API-режим** — прямые вызовы моделей с параллельным выполнением через OpenAI, Gemini, DeepSeek, Groq, Ollama
* **CLI-режим** — дебаты через агентские CLI, которые у вас уже есть (`claude`, `codex` и другие), работают по вашей **подписке, а не по API-кредитам**
* **brainstorm\_quick** — мгновенные мнения нескольких моделей за время меньше 10 секунд
* **brainstorm\_review** — мультимодельное код-ревью со структурированными выводами, оценками серьёзности и вердиктами
* **Стили дебатов** — свободный, red-team (атакующий) и сократический (задающий вопросы)
* **Загрузка контекста** — привязка дебатов к реальному коду, диффам или документам по архитектуре
* **Синтез-вердикт из трёх пунктов** — Рекомендация, Ключевые компромиссы, Наиболее сильное разногласие
* **Claude как участник** — Claude участвует в дебатах наряду с внешними моделями, имея полный контекст разговора
* **Многораундовые дебаты** — модели увили и критикуют ответы друг друга между раундами
* **Параллельное выполнение** — все модели отвечают одновременно в каждом раунде
* **Отказоустойчивость** — сбой одной модели не прерывает дебаты
* **Кроссплатформенность** — работает в macOS, Windows и на Linux

## Установка (60 секунд)

GXP1

Этого достаточно для hosted-режима (ни API-ключей не нужно — дебаты выполняются на моделях, уже доступных в вашей среде). Добавьте ключи провайдеров, чтобы подкосить в дебаты GPT, Gemini, DeepSeek, Groq или Ollama.

### Claude Code

Добавьте в файл `.mcp.json` вашего проекта:

GXP2

### Claude Desktop

Добавьте в `claude_desktop_config.json`:

GXP3

### Установка вручную

GXP4

> **Hosted-режим** не требует API-ключей — просто установите и работайте. Хост (Claude Code) выполняет промпты с помощью собственного доступа к моделям.

## Настройка

### Вариант 1: Переменные окружения (проще всего)

GXP5

### Вариант 2: Файл конфигурации (полный контроль)

Задайте `BRAINSTORM_CONFIG`, чтобы указать на JSON-конфигурацию:

GXP6

Хорошо известные провайдеры (`openai`, `gemini`, `deepseek`, `groq`, `mistral`, `together`, `moonshot`, `minimax`, `glm`, `qwen`) не требуют значения `baseURL`.

### Вариант 3: CLI-провайдеры (используйте подписку, а не API-кредиты)

Если вы уже платите за Claude Code, Codex, Gemini CLI и иные CLI, brainstorm может запускать эти CLI, а не покупать API-кредиты. **Любой агентный CLI, найденный в вашем `PATH`, автоматически регистрируется при запуске** — настраивать ничего не нужно:

GXP7

Используйте их как любого другого провайдера:

GXP8

Встроенные адаптеры:

| Провайдер       | Команда            | Модель по умолчанию | Статус                     |
| --------------- | ------------------ | ------------------- | -------------------------- |
| `claude`        | `claude -p`        | `sonnet`            | проверено                  |
| `codex`         | `codex exec`       | `default` | проверено                  |
| `gemini`        | `gemini -p`        | `gemini-2.5-pro`    | best-effort, требует проверки |
| `cursor-agent`  | `cursor-agent -p`  | `default`           | best-effort                |
| `opencode`      | `opencode run`     | `default`           | best-effort                |
| `qwen`          | `qwen -p`          | `qwen3-coder-plus`  | best-effort                |
| `kimi`          | `kimi --print`     | `default`           | best-effort                |
| `droid`         | `droid exec`       | `default`           | best-effort                |

`<provider>:default` означает "пусть CLI использовать ту модель по умолчанию, какая у него стоит". Вызовы CLI запускаются с отключенными инструментами и доступом только на чтение в песочнице, где CLI это поддерживает: они генерируют текст и не трогают ваш репозиторий. Специфичные для провайдеров переменные с API-ключами (`ANTHROPIC_API_KEY`, `OPENAI_API_KEY`) исключаются из дочернего процесса, чтобы CLI вернулся к вашей подписке.

Параметры окружения:

| Переменная                   | Эффект                                                                             |
| ---------------------------- | ---------------------------------------------------------------------------------- |
| `BRAINSTORM_CLI_PROVIDERS`   | `auto` (по умолчанию), `off` или разделённый запятыми список адаптеров для обнаружения |
| `BRAINSTORM_PREFER_CLI`      | `1` — для дебатов без явных `models` использовать только CLI-провайдера, не обращаясь к тарифицируемым API |
| `BRAINSTORM_CLI_TIMEOUT_MS`  | Таймаут вызова для CLI-провайдеров (по умолчанию 300000)          |

Чтобы закрепить модель или добавить CLI, которого нет в списке встроенных, используйте конфигурационный файл:

GXP9

Плейсхолдеры шаблона: `{{model}}`, `{{system}}`, `{{prompt}}`, `{{outfile}}`. Одиночный плейсхолдер, который преобразуется в ничего, исчезает из командной строки вместе с флагом, который его вводит, поэтому `["--model", "{{model}}"]` работает даже для `provider:default`. Задайте `"promptVia": "stdin"`, чтобы передавать промпт на stdin, а не аргументом.

#### Бэкенды подписки на код через CLI Claude

Moonshot (Kimi), MiniMax и Z.ai (GLM) продают подписки на разработку, которые говорят на Anthropic API. Направьте бинарный файл `claude` на одного из них, и этот вендор присоединится к дебатам за план, который вы уже оплачиваете:

GXP10

| Backend    | Endpoint                            | Переменная с токеном |
| ---------- | ----------------------------------- | -------------------- |
| `moonshot` | `https://api.moonshot.ai/anthropic` | `MOONSHOT_API_KEY`  |
| `minimax`  | `https://api.minimax.io/anthropic`  | `MINIMAX_API_KEY`   |
| `glm`      | `https://api.z.ai/api/anthropic`    | `ZAI_API_KEY`       |

Токен считывается из вашего окружения в момент вызова — в конфигурации хранится имя переменной, а не сам секрет. `ANTHROPIC_API_KEY` удаляется из дочернего, чтобы ваш аккаунт Anthropic никогда не оплачивал их вызовы. Любой CLI-провайдер также принимает блок `"env"` для ручного переноса на другой бэкенд; значение `"$NAME"` означает его переменную из окружения сервера.

Эти вендоры также доступны как обычные API — `moonshot`, `minimax`, `glm` и `qwen` имеют известные базовые URL, поэтому одного `MOONSHOT_API_KEY` достаточно, чтобы зарегистрировать `moonshot` как API-провайдера.

## Инструменты

| Инструмент           | Описание                                                     | Аннотация       |
| -------------------- | ------------------------------------------------------------ | --------------- |
| `brainstorm`         | Многораундовые дебаты между ИИ-моделями (API-режим или hosted) | readOnly        |
| `brainstorm_quick`   | Мгновенные мнения -- параллельно, без раундов                 | readOnly        |
| `brainstorm_review`  | Мультимодельное код-ревью с выводами, серьёзностью, вердиктом  | readOnly        |
| `brainstorm_respond` | Отправить ответ Claude в интерактивном сеансе                 | readOnly        |
| `brainstorm_collect` | Собрать ответы моделей в hosted-сессии                         | readOnly        |
| `list_providers`     | Показать настроенные провайдеров, состояния API-ключей и найденые CLI | readOnly        |
| `add_provider`       | Добавить нового API- или CLI-провайдера во время выполнения     | non-destructive  |

## Примеры использования

### Пример 1: Быстрые мнения разных моделей

**Промпт:** "Use brainstorm\_quick to compare Redis vs PostgreSQL for session storage"

**Инструмент:** `brainstorm_quick`

GXP11

**Результат:** Каждая настроенна модель самостоятельный параллельно. Вы получаете сравнение рядом за время меньше 10 секунд с именами моделей, ответами, временем и стоимостью.

**Обработка ошибок:**

* [saga-mcp](https://github.com/spranab/saga-mcp) — трекер проектов на базе SQLite: когда спор утихает, решение попадает в долговечное хранилище.
* [yantrikdb-mcp](https://github.com/yantrikos/yantrikdb-mcp) — постоянная когнитивная память, чтобы агент помнил, что вы решили и почему.
* [swarmcode](https://github.com/spranab/swarmcode) — канал в реальном времени между экземплярами Claude Code на разных машинах.
* [truenas-mcp](https://github.com/spranab/truenas-mcp) — 278 действий TrueNAS SCALE в одном иерархическом инструменте.
* [mcpier](https://github.com/spranab/mcpier) — самостоятельно размещаемая плоскость управления MCP, которая не допускает API-ключи к вашим клиентам.

## Лицензия

MIT