Claude Team MCP

<div align="center"> # 🤖 Claude Team **AI 开发团队的多智能体 MCP 服务器** *让 GPT、Claude、Gemini 等多个模型协作完成复杂任务* [](https://www.npmjs.com/package/claude-team) [](https://www.npmjs.com/package/claude-team) [](https://nodejs.org/) [](https://modelcontextprotocol.io) [](LICENSE) [](https://github.com/7836246/claude-team-mcp) [English](README.md) | [简体中文](README_CN.md) </div> --- ## ✨ 特性 | 特性 | 描述 | |------|------| | 🤖 **多模型协作** | 配置多个 AI 模型协同工作，各自发挥所长 | | 🧠 **智能任务分配** | Tech Lead 分析任务，自动分配给最合适的专家 | | 🔗 **工作流模板** | 5 个预定义工作流：代码生成、Bug修复、重构、审查、文档 | | 🎯 **自定义专家** | 通过环境变量定义专家（Rust、K8s、安全等） | | 📊 **可观测性** | 仪表板、成本预估、任务规划预览 | | 🌐 **中转 API 支持** | 自定义 Base URL，兼容各种代理服务 | | 📝 **协作历史** | 完整记录所有协作，支持搜索和回顾 | --- ## 🚀 快速开始 ### 安装 ```bash # 全局安装 npm install -g claude-team # 或直接使用 npx（无需安装） npx claude-team ``` ### 基础配置 在 IDE 的 MCP 配置文件中添加： <details> <summary><b>📍 配置文件位置</b></summary> | IDE | 路径 | |-----|------| | **Claude Code** | `~/.claude/config.json` | | **Windsurf** | `~/.codeium/windsurf/mcp_config.json` | | **Cursor** | `~/.cursor/mcp.json` | </details> ```json { "mcpServers": { "claude-team": { "command": "npx", "args": ["-y", "claude-team"], "env": { "CLAUDE_TEAM_MAIN_KEY": "sk-your-api-key", "CLAUDE_TEAM_MAIN_URL": "https://api.openai.com/v1", "CLAUDE_TEAM_MAIN_MODEL": "gpt-4o", "CLAUDE_TEAM_MAIN_PROVIDER": "openai" } } } } ``` ### 开始使用 ``` > 帮我用团队协作完成一个用户登录功能 > 让团队帮我优化这段代码的性能 ``` --- ## 🎬 工作原理 ``` 用户: "优化这个 SQL 查询的性能" Tech Lead 分析 → ├── 创建: SQL 优化专家 (powerful) ├── 创建: 索引分析专家 (balanced) └── 工作流: sequential ``` ``` 用户: "写一个带暗黑模式的设置页面" Tech Lead 分析 → ├── 创建: UI 组件专家 (balanced) ├── 创建: 主题系统专家 (fast) ├── 创建: 状态管理专家 (balanced) └── 工作流: parallel → review ``` --- ## 🛠️ 可用工具 ### 核心工具 | 工具 | 描述 | |------|------| | `team_work` | 🚀 团队协作完成任务（自动创建专家） | | `ask_expert` | 💬 咨询专家（支持自定义专家） | | `code_review` | 🔍 代码审查 | | `fix_bug` | 🐛 Bug 修复 | ### 工作流工具 | 工具 | 描述 | |------|------| | `list_workflows` | 📋 列出所有工作流模板 | | `run_workflow` | ▶️ 执行指定工作流 | | `suggest_workflow` | 💡 根据任务自动推荐工作流 | **预定义工作流：** | 工作流 | 用途 | 步骤 | |--------|------|------| | `code-generation` | 从需求生成代码 | 架构设计 → 代码实现 → 测试 → 审查 | | `bug-fix` | 诊断和修复 Bug | 问题诊断 → 修复实现 → 验证 | | `refactoring` | 代码重构 | 代码分析 → 重构计划 → 执行 → 审查 | | `code-review` | 多维度代码审查 | 安全/质量/性能（并行审查） | | `documentation` | 生成技术文档 | 代码分析 → 文档生成 | ### 可观测性工具 | 工具 | 描述 | |------|------| | `team_dashboard` | 🎛️ 查看团队状态：专家、模型、统计 | | `cost_estimate` | 💰 预估任务成本（Token、费用、耗时） | | `explain_plan` | 🧠 预览任务分配方案 | | `usage_stats` | 📈 查看模型使用统计 | ### 集成工具 | 工具 | 描述 | |------|------| | `read_project_files` | 📄 读取项目文件，提供代码上下文 | | `analyze_project_structure` | 🏗️ 分析项目结构和技术栈 | | `generate_commit_message` | 📝 根据 diff 生成 commit message | ### 历史记录工具 | 工具 | 描述 | |------|------| | `history_list` | 📋 查看协作历史 | | `history_get` | 📄 获取历史详情 | | `history_search` | 🔎 搜索历史记录 | | `history_context` | 📚 获取最近上下文 | --- ## ⚙️ 配置说明 ### 环境变量 | 变量 | 必需 | 说明 | |------|------|------| | `CLAUDE_TEAM_MAIN_KEY` | ✅ | 主模型 API Key | | `CLAUDE_TEAM_MAIN_URL` | ❌ | 主模型 API 地址 | | `CLAUDE_TEAM_MAIN_MODEL` | ❌ | 主模型 ID（默认 gpt-4o） | | `CLAUDE_TEAM_MAIN_PROVIDER` | ❌ | 提供商：`openai` / `anthropic` / `gemini` | | `CLAUDE_TEAM_MODEL{N}_*` | ❌ | 工作模型 N 配置（继承 MAIN） | | `CLAUDE_TEAM_CUSTOM_EXPERTS` | ❌ | 自定义专家配置（JSON 格式） | > N = 1, 2, 3... 最多支持 10 个工作模型 ### 自定义专家 除了内置的 `frontend`、`backend`、`qa` 专家，你可以定义自己的： ```json { "env": { "CLAUDE_TEAM_CUSTOM_EXPERTS": "{\"rust\":{\"name\":\"Rust专家\",\"prompt\":\"你是Rust专家...\",\"tier\":\"powerful\"},\"k8s\":{\"name\":\"K8s专家\",\"prompt\":\"你是Kubernetes专家...\",\"tier\":\"balanced\"}}" } } ``` | 字段 | 必需 | 说明 | |------|------|------| | `name` | ✅ | 专家显示名称 | | `prompt` | ✅ | 专家角色描述（System Prompt） | | `tier` | ❌ | 模型级别：`fast` / `balanced` / `powerful` | | `skills` | ❌ | 技能标签数组 | ### 模型能力级别 | 级别 | 用途 | 示例场景 | |------|------|---------| | `fast` | 简单、快速任务 | 格式化、简单查询、文档生成 | | `balanced` | 常规开发任务 | 组件开发、API 实现、单元测试 | | `powerful` | 复杂推理任务 | 架构设计、性能优化、安全审计 | --- ## 📦 更新日志 ### v0.4.0 - 🎯 **自定义专家** - 通过环境变量定义专家 - 🔗 **工作流模板** - 5 个预定义工作流 - 📊 **可观测性** - 仪表板、成本预估、方案预览 - 🔌 **项目集成** - 文件读取、结构分析、commit 生成 - 💡 **智能推荐** - 自动推荐工作流 - 🧪 **测试覆盖** - 155 个测试用例 ### v0.3.0 - 🔄 任务中断/恢复支持 - 💬 专家多轮对话 - 📊 Token 计数和成本预估 - 📋 专家模板（6 个内置 + 自定义） - 🔔 Webhook 通知 - ⚡ 指数退避重试 - 🔧 配置热重载 <details> <summary>更早版本</summary> ### v0.2.x - 🌊 流式输出支持 - 📊 使用统计 - 🎯 模型策略 - 💾 结果缓存 - 🔄 自动模型切换 ### v0.1.x - 🎉 首次发布 - 🤖 多模型协作 - 🌐 中转 API 支持 </details> --- ## 🤝 贡献 欢迎贡献！请先阅读： - [贡献指南](CONTRIBUTING.md) - [行为准则](CODE_OF_CONDUCT.md) - [安全策略](SECURITY.md) ## 📄 许可证 [MIT](LICENSE) --- <div align="center"> ## ⭐ Star History [](https://star-history.com/#7836246/claude-team-mcp&Date) --- **[⬆ 返回顶部](#-claude-team)** Made with ❤️ by the community </div>