brainstorm-mcp

한 모델에게 디자인 질문을 하면 확신에 찬 답 하나를 얻지만, 어느 부분을 확신하지 못하는지에 대한 신호는 없습니다. 세 모델에게 물어보면 그 불일치가 바로 신호가 됩니다.

brainstorm-mcp는 에디터 안에서 GPT, Gemini, DeepSeek, Claude 및 로컬 Ollama 모델 간의 다중 라운드 토론을 실행합니다. 모델들은 서로의 답변을 보고 라운드에 걸쳐 비판하며, 그 후 3가지 요점으로 구성된 종합(추천, 주요 트레이드오프, 가장 강한 불일치)을 받게 됩니다. 또한 즉석 퀵 모드, 평결이 포함된 다중 모델 코드 리뷰, 레드팀/소크라테스 스타일도 지원합니다. 호스팅 모드는 API 키가 전혀 필요 없습니다.

하나의 AI를 믿지 마세요. 그들이 논쟁하게 하세요.

데모

클릭하여 시청하세요: 3개 모델이 토론하고, 상호 검증하며, 구조화된 평결을 생성합니다 — 모두 Claude Code 안에서.

기능

• 호스팅 모드 — API 키 불필요. 환경의 모델(Claude Opus/Sonnet/Haiku)을 하위 에이전트로 사용

• API 모드 — OpenAI, Gemini, DeepSeek, Groq, Ollama에서 병렬 실행되는 직접 모델 API 호출

• CLI 모드 — 이미 보유한 에이전트 CLI(claude, codex 등)를 통해 토론 실행 — 토론이 API 크레딧 대신 구독으로 실행됨

• brainstorm_quick — 10초 이내의 즉석 다중 모델 관점

• brainstorm_review — 구조화된 결과, 심각도 등급, 평결이 포함된 다중 모델 코드 리뷰

• 토론 스타일 — 자유 형식, 레드팀(적대적), 소크라테스(탐구 질문)

• 컨텍스트 주입 — 실제 코드, diff, 아키텍처 문서에 토론 근거를 둠

• 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은 API 크레딧을 구매하는 대신 해당 CLI를 호출할 수 있습니다. 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: 다중 모델 코드 리뷰

프롬프트: "이 diff를 보안 문제로 리뷰하세요" (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에 전달되며, 이 CLI는 기존 구독으로 자체 공급자와 통신합니다. 호스팅 모드에서는 외부 API 호출이 이루어지지 않습니다.

토론 세션은 10분 TTL로 메모리에만 저장됩니다. 결과를 명시적으로 저장하지 않는 한 디스크에 데이터가 기록되지 않습니다.

전체 개인정보 보호 정책: 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 — 클라이언트에서 API 키를 분리하는 자체 호스팅 MCP 컨트롤 플레인.

라이선스

MIT