brainstorm-mcp

向一个模型提出设计问题，你会得到一个自信的答案，却无法得知它哪些部分不确定。问三个模型，分歧本身就是信号。

brainstorm-mcp 在你的编辑器内运行 GPT、Gemini、DeepSeek、Claude 和本地 Ollama 模型之间的多轮辩论：它们会看到并互相批评彼此的答案，经过多轮后，你会得到一份 3 条要点的综合结论——建议、关键权衡、最强烈的分歧。它还支持即时快速模式、带裁决的多模型代码审查，以及红队/苏格拉底式风格。托管模式无需任何 API 密钥。

不要相信单一 AI。让它们争论。

演示

点击观看：3 个模型辩论、交叉质询，并产生结构化裁决——全部在 Claude Code 内完成。

功能

• 托管模式 — 无需 API 密钥。通过子代理使用你环境中的模型（Claude Opus/Sonnet/Haiku）

• API 模式 — 直接调用模型 API，在 OpenAI、Gemini、DeepSeek、Groq、Ollama 之间并行执行

• CLI 模式 — 通过你已有的代理 CLI（claude、codex 等）进行辩论，因此辩论使用你的订阅而非 API 额度

• brainstorm_quick — 10 秒内获得即时多模型视角

• brainstorm_review — 多模型代码审查，包含结构化发现、严重性评级和裁决

• 辩论风格 — 自由形式、红队（对抗性）和苏格拉底式（追问式）

• 上下文注入 — 将辩论基于实际代码、差异或架构文档

• 3 条要点综合裁决 — 建议、关键权衡、最强烈的分歧

• Claude 作为参与者 — Claude 与外部模型一起辩论，拥有完整对话上下文

• 多轮辩论 — 模型在多轮中看到并批评彼此的回应

• 并行执行 — 每轮中所有模型同时响应

• 弹性 — 一个模型失败不会中止辩论

• 跨平台 — 支持 macOS、Windows 和 Linux

Related MCP server: roundtable-mcp

安装（60秒）

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

这足以用于托管模式（无需 API 密钥——它使用你环境中已有的模型进行辩论）。添加提供者密钥，即可将 GPT、Gemini、DeepSeek、Groq 或 Ollama 引入辩论。

Claude Code

添加到项目的 .mcp.json：

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

Claude Desktop

添加到 claude_desktop_config.json：

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

手动安装

npm install -g brainstorm-mcp
brainstorm-mcp

托管模式无需 API 密钥——安装即可使用。宿主（Claude Code）使用自己的模型访问权限执行提示。

配置

选项 1：环境变量（最简单）

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

选项 2：配置文件（完全控制）

设置 BRAINSTORM_CONFIG 指向一个 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" }
  }
}

已知提供者（openai、gemini、deepseek、groq、mistral、together、moonshot、minimax、glm、qwen）不需要 baseURL。

选项 3：CLI 提供者（使用订阅，而非 API 额度）

如果你已经为 Claude Code、Codex、Gemini CLI 等付费，brainstorm 可以调用这些 CLI，而不是购买 API 额度。任何在你的 PATH 中找到的代理 CLI 都会在启动时自动注册——无需配置：

[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"] }

内置适配器：

<provider>:default 表示“让 CLI 使用它配置的任何模型”。CLI 调用在禁用工具的情况下运行，并在 CLI 支持的地方使用只读沙箱——它们生成文本，不会触碰你的仓库。提供者特定的 API 密钥环境变量（ANTHROPIC_API_KEY、OPENAI_API_KEY）会从子进程中剥离，因此 CLI 会回退到你的订阅登录。

环境变量选项：

要固定模型或添加未内置的 CLI，请使用配置文件：

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

模板占位符：{{model}}、{{system}}、{{prompt}}、{{outfile}}。一个解析为空的单独占位符会连同引入它的标志一起从命令行中删除，因此 ["--model", "{{model}}"] 即使对于 provider:default 也能正常工作。设置 "promptVia": "stdin" 以通过管道传递提示，而不是作为参数传递。

通过 Claude CLI 使用编码计划后端

Moonshot (Kimi)、MiniMax 和 Z.ai (GLM) 销售支持 Anthropic API 的编码计划订阅。将 claude 二进制指向其中一个，该供应商就会在你已付费的计划上加入辩论：

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

令牌在调用时从你的环境中读取——配置文件保存的是变量名，而不是秘密。ANTHROPIC_API_KEY 会从子进程中剥离，因此你的 Anthropic 账户绝不会为这些调用付费。任何 CLI 提供者还接受 "env" 块来手动覆盖后端；值为 "$NAME" 时通过服务器的环境间接引用。

这些供应商也可以作为普通的计量 API 访问——moonshot、minimax、glm 和 qwen 有已知的基础 URL，因此仅凭 MOONSHOT_API_KEY 就足以将 moonshot 注册为 API 提供者。

工具

使用示例

示例 1：快速多模型视角

提示： “使用 brainstorm_quick 比较 Redis 与 PostgreSQL 用于会话存储”

调用的工具： brainstorm_quick

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

输出： 每个配置的模型独立并行响应。你会在 10 秒内获得并排比较，包含模型名称、响应、时间和成本。

错误处理： 如果某个模型失败（速率限制、超时），工具会继续使用其余模型，并显示哪些模型失败。

示例 2：多模型代码审查

提示： “审查此差异是否存在安全问题”（粘贴 git diff）

调用的工具： brainstorm_review

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

输出： 结构化裁决（批准 / 带警告批准 / 需要更改），包含发现表，显示严重性、类别、文件、行号和建议。还包括模型一致性分析——多个模型标记的问题具有更高的置信度。

错误处理： 如果综合失败，仍会返回原始模型审查。

示例 3：托管模式头脑风暴（无需 API 密钥）

提示： “使用 opus、sonnet 和 haiku 进行头脑风暴，讨论我们应该使用 GraphQL 还是 REST”

调用的工具： brainstorm

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

输出： 工具为每个模型返回提示。宿主（Claude Code）生成使用不同模型的子代理，收集响应，并通过 brainstorm_collect 反馈。所有轮次结束后，综合模型产生 3 条要点裁决：建议、关键权衡、最强烈的分歧。

错误处理： 会话在 10 分钟后过期。如果找不到会话，会返回清晰的错误消息，并附有启动新会话的说明。

工作原理

API / CLI 模式

1. 你要求 Claude 对一个主题进行头脑风暴

2. 工具将主题并行发送给所有配置的提供者——API 提供者使用 HTTP，CLI 提供者使用生成的子进程

3. Claude 阅读它们的响应，并贡献自己的视角

4. 模型看到彼此的响应，并在多轮中完善

5. 综合器产生最终裁决

托管模式

1. 你要求 Claude 使用特定模型（例如 opus、sonnet、haiku）进行头脑风暴

2. 工具返回提示——不进行任何 API 调用

3. Claude 生成使用不同模型的子代理来执行提示

4. 收集响应并反馈给下一轮

5. 重复直到综合

隐私政策

brainstorm-mcp 完全在你的机器上运行，不收集、存储或传输任何个人数据、遥测或分析。

在 API 模式下，提示直接从你的机器发送到你配置的模型提供者（OpenAI、Gemini、DeepSeek 等），使用你自己的 API 密钥。在 CLI 模式下，提示传递给你机器上安装的代理 CLI，它们在你现有的订阅下与各自的供应商通信。在 托管模式下，不进行任何外部 API 调用。

辩论会话仅存储在内存中，TTL 为 10 分钟。除非你明确保存结果，否则不会向磁盘写入任何数据。

完整隐私政策：PRIVACY.md

支持

• 问题：https://github.com/spranab/brainstorm-mcp/issues

• 邮箱：developer@pranab.co.in

• 仓库：https://github.com/spranab/brainstorm-mcp

开发

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

相关项目

同一作者的其他代理基础设施，设计为一起使用：

• saga-mcp — 基于 SQLite 的项目追踪器：一旦讨论尘埃落定，决策就会存入持久化存储。

• yantrikdb-mcp — 持久化认知记忆，让代理记住你做了什么决定以及为什么。

• swarmcode — 不同机器上 Claude Code 实例之间的实时通道。

• truenas-mcp — 278 个 TrueNAS SCALE 操作，统一封装在一个分层工具中。

• mcpier — 自托管的 MCP 控制平面，让 API 密钥远离你的客户端。

许可证

MIT