头脑
多模型审议MCP服务器。并行向GPT、Gemini和Grok发出扇出提示,返回结构化响应供Claude(或任何MCP主机)合成。
快速开始
git clone https://github.com/jacodecob/brainstew.git
cd brainstew
npm install
npm run build添加到克劳德代码
如果您克隆了仓库并从项目目录中打开Claude Code .mcp.json 已包含-只需设置您的API密钥:
claude mcp add brainstew \
-e OPENAI_API_KEY=sk-your-key \
-e GEMINI_API_KEY=your-key \
-e XAI_API_KEY=xai-your-key \
-- node dist/index.js或编辑 .mcp.json 在项目根目录中(已包含在仓库中):
{
"mcpServers": {
"brainstew": {
"command": "node",
"args": ["dist/index.js"],
"env": {
"OPENAI_API_KEY": "sk-your-key",
"GEMINI_API_KEY": "your-key",
"XAI_API_KEY": "xai-your-key",
"GOOGLE_OAUTH_CLIENT_ID": "your-google-oauth-client-id"
}
}
}
}添加到其他MCP主机
Brainstew使用stdio传输。任何兼容MCP的主机(Codex、OpenCode等)都可以以相同的方式启动它——运行 node dist/index.js 并通过stdin/stdout进行通信。将API键作为环境变量传递。
认证
API密钥(主要方法)
大多数提供程序都需要API密钥。获取你的并将其作为env变量传递:
| 提供者 | 环境变量 | 获取密钥 |
|---|---|---|
| OpenAI(GPT-4o) | OPENAI_API_KEY | https://platform.openai.com/api-keys |
| 谷歌(双子座) | GEMINI_API_KEY | https://aistudio.google.com/apikey |
| xAI(格罗克) | XAI_API_KEY | https://console.x.ai |
您可以在MCP配置中设置env变量(见上文) .env 项目根目录下的文件(cp .env.example .env)或者在你的壳里。Brainstew自动加载项目根目录 .env 无需启动 node --env-file.
引导式设置
首次使用时,客服会致电 brainstew_setup 检查配置了哪些提供程序,并指导用户完成设置。你也可以问:
Run brainstew_setup to check my configurationOAuth(仅限谷歌,可选)
Google Gemini可选择通过PKCE支持OAuth。这需要一个Google Cloud OAuth客户端ID:
- 在中创建OAuth客户端 谷歌云控制台
- 集
GOOGLE_OAUTH_CLIENT_IDenv 是 - 请代理人打电话
brainstew_login与供应商google
OpenAI和xAI确实如此 不 支持OAuth访问API-仅限API密钥。
凭证优先级
- 存储的OAuth令牌(操作系统密钥链——仅限谷歌)
- 存储的API密钥
- 环境变量API键
工具
brainstew_setup
引导首次运行配置。显示哪些提供程序已准备就绪,哪些提供程序需要API密钥和直接链接。
brainstew_council
并行向多个模型扇出提示。使用延迟和auth方法返回每个模型的响应。
prompt: "What's the best approach for caching in a distributed system?"
models: ["gpt", "gemini", "grok"] # optional, defaults to all three
context: "We use Redis and PostgreSQL" # optional返回文本摘要和键入的内容 structuredContent 具有每个模型的响应对象。在每个模型完成时发出进度通知。
brainstew_login
通过OAuth(唯一支持它的提供商)与谷歌进行身份验证。请勿用于OpenAI或xAI。
brainstew_auth_status
检查所有提供程序的凭据状态。显示每个都在使用OAuth、API密钥还是未配置。
发展
npm run dev # run with tsx (hot reload)
npm run build # compile TypeScript
npm start # run compiled outputMCP检验员测试
npx @modelcontextprotocol/inspector --cli --transport stdio -- node dist/index.js --method tools/list
npx @modelcontextprotocol/inspector --cli --transport stdio -- node dist/index.js --method tools/call --tool-name brainstew_setup
npx @modelcontextprotocol/inspector --cli --transport stdio -- node dist/index.js --method tools/call --tool-name brainstew_auth_status建筑
src/index.ts--MCP服务器、工具注册、格式化src/auth.ts--OAuth PKCE流、密钥链存储、令牌刷新、凭证解析src/providers.ts-特定于模型的API调用(OpenAI、Google、xAI)docs/reference/--设计决策和认证策略文档
与 MCP TypeScript SDK (@modelcontextprotocol/sdk).
许可证
麻省理工学院
