HIVE Agent Teams

智能多 Agent 协作系统 - 通过 MCP 协议集成到 AI IDE

🎯 项目简介

HIVE Agent Teams 是一个基于 MCP (Model Context Protocol) 的多 Agent 协作框架，可以无缝集成到 Cursor、Claude Desktop 等 AI IDE 中。

核心特点：在 IDE 聊天界面中用自然语言指挥 AI 团队

✨ 核心特性

🔌 MCP 协议集成

• 标准协议: 基于 Model Context Protocol，支持多个 AI IDE
• 无缝集成: 一次配置，自动工作
• 自然交互: 在 IDE 聊天界面中用自然语言操作

🤖 多 Agent 协作

• 10 种预设模板: fullstack、backend、frontend、mobile、research、design 等
• 智能分工: 自动分配任务给合适的 Agent
• 团队协作: Agent 之间自动协作完成复杂任务
• 真正并行: 每个 Agent 是独立的进程，真正的并行执行
• 视角切换: 可以切换到任意 Agent 的视角查看工作进度
• 并行验证: 实时验证 Agent 们是否在并行工作

🧠 智能知识系统

• 三级缓存架构: Agent 本地缓存 → Team 共享缓存 → 全局知识库
• 自动进化: 从项目经验中学习，持续优化策略
• 模式识别: 自动识别成功模式和反模式
• 智能推荐: 基于历史数据的最佳实践推荐

🛠️ IDE 工具集成

• 文件操作: Read、Write、Edit
• 代码搜索: Glob、Grep
• 命令执行: Bash
• 完全访问: Agent 可以使用 IDE 的所有工具

📦 安装

1. 安装 HIVE

npm install -g hive-agent-teams

2. 配置 MCP 服务器

Cursor 配置

编辑 MCP 配置文件：

Windows: %APPDATA%\Cursor\User\mcp.json macOS/Linux: ~/.cursor/mcp.json

添加以下配置：

{
  "mcpServers": {
    "hive": {
      "command": "npx",
      "args": ["-y", "hive-agent-teams"]
    }
  }
}

Windows 用户特别说明：如果遇到问题，可以使用完整路径：

{
  "mcpServers": {
    "hive": {
      "command": "node",
      "args": [
        "C:/Users/你的用户名/AppData/Roaming/npm/node_modules/hive-agent-teams/dist/mcp-server.js"
      ]
    }
  }
}

Claude Desktop 配置

Windows: %APPDATA%\Claude\claude_desktop_config.json macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Linux: ~/.config/Claude/claude_desktop_config.json

添加以下配置：

{
  "mcpServers": {
    "hive": {
      "command": "npx",
      "args": ["-y", "hive-agent-teams"]
    }
  }
}

iflow CLI IDE 配置

Windows: %APPDATA%\iflow\mcp.json

{
  "mcpServers": {
    "hive": {
      "command": "node",
      "args": [
        "%APPDATA%/Roaming/npm/node_modules/hive-agent-teams/dist/mcp-server.js"
      ]
    }
  }
}

macOS/Linux: ~/.iflow/mcp.json

{
  "mcpServers": {
    "hive": {
      "command": "npx",
      "args": ["-y", "hive-agent-teams"]
    }
  }
}

3. 重启 IDE

配置完成后，重启 Cursor、Claude Desktop 或 iflow CLI IDE。

🚀 使用方法

安装配置完成后，在 IDE 的聊天界面中用自然语言操作：

你: 创建一个全栈开发团队

AI: [调用 HIVE create_team 工具]
✅ 团队创建成功！
团队名称: fullstack-team
团队规模: 8 人
角色: pm, system-architect, ui-ux-designer, backend-architect,
      frontend-architect, backend-dev, frontend-dev, qa

你: 让后端架构师设计用户认证 API

AI: [调用 HIVE assign_task 工具]
✅ 任务已分配给 backend-architect

你: 查看团队状态

AI: [调用 HIVE get_status 工具]
📊 团队状态:
  团队 ID: fullstack-team
  状态: active
  成员数: 8
  Token 使用: 1250/50000

常见操作

创建团队

创建一个全栈开发团队
创建一个后端团队
创建一个设计团队

分配任务

让后端架构师设计用户认证 API
让前端开发实现登录页面
让 UI/UX 设计师设计用户界面
让 QA 编写测试用例

查看状态

查看团队状态
显示当前团队信息
列出所有团队

切换 Agent 视角

查看后端架构师的工作进度
切换到前端开发的视角
显示 UI/UX 设计师的活动日志

验证并行工作

验证 Agent 们是否在并行工作
检查团队是否真的在并行协作
显示所有 Agent 的实时状态

查看通信记录

查看团队的通信记录
查看 backend-architect 和 frontend-architect 之间的对话
显示 pm 的所有消息
查看最近 50 条团队消息

管理团队

列出所有可用的模板
切换到 backend-team
销毁当前团队

详细文档: MCP 安装指南 | iflow 使用指南 | Cursor 使用指南 | Agent 视角切换指南 | Agent 通信记录指南

📋 可用的团队模板

HIVE 提供 10 种预设团队模板：

1. fullstack (8人) - 全栈开发团队

   • pm, system-architect, ui-ux-designer, backend-architect, frontend-architect, backend-dev, frontend-dev, qa

2. backend (5人) - 后端开发团队

   • system-architect, backend-architect, senior-backend-dev, backend-dev, qa

3. frontend (5人) - 前端开发团队

   • ui-ux-designer, frontend-architect, senior-frontend-dev, frontend-dev, qa

4. mobile (6人) - 移动开发团队

   • ui-ux-designer, mobile-architect, ios-dev, android-dev, backend-dev, qa

5. research (5人) - 产品调研团队

   • market-researcher, business-analyst, user-researcher, data-analyst, product-strategist

6. design (4人) - 设计团队

   • ui-ux-designer, visual-designer, interaction-designer, design-system-specialist

7. architecture (4人) - 架构团队

   • system-architect, backend-architect, frontend-architect, devops-architect

8. validation (4人) - 产品验证团队

   • product-manager, ui-ux-designer, fullstack-dev, qa

9. small (3人) - 小型开发团队

   • fullstack-dev, ui-ux-designer, qa

10. large (12人) - 大型开发团队

    • pm, team-lead, system-architect, ui-ux-designer, backend-architect, frontend-architect, senior-backend-dev, backend-dev, frontend-dev, qa, devops-engineer, security-engineer

🧪 测试

运行测试套件：

npm test

测试覆盖：

• MCP 服务器: 15/15 ✅
• Quick Start: 19/19 ✅
• Cursor 适配器: 27/27 ✅
• iflow 适配器: 21/21 ✅
• 知识系统: 17/17 ✅
• 总计: 99/99 全部通过

📖 文档

使用指南

• MCP 安装指南 ⭐ 所有 IDE 通用安装指南
• iflow 使用指南 - iflow CLI IDE 专用
• 快速启动指南
• Agent 视角切换和并行验证 ⭐ 新功能

技术文档

• 知识系统使用指南
• iflow 适配器 API
• Cursor 适配器 API

🏗️ 项目结构

src/
├── mcp-server.ts       # MCP 服务器入口
├── quick-start.ts      # 快速启动 API
├── knowledge/          # 知识积累系统
│   ├── agent-cache.ts  # Agent 本地缓存
│   ├── team-cache.ts   # Team 共享缓存
│   ├── global-kb.ts    # 全局知识库
│   └── evolution.ts    # 自动进化系统
├── adapters/           # IDE 适配器
│   ├── iflow-adapter.ts
│   └── cursor-adapter.ts
├── core/               # 核心功能
│   ├── team-manager.ts
│   └── agent-manager.ts
├── storage/            # 数据存储
│   └── database.ts
└── types/              # 类型定义

🎓 技术栈

• 语言: TypeScript 5.0+
• 运行时: Node.js 20+
• 协议: Model Context Protocol (MCP)
• 数据库: SQLite 3 (better-sqlite3)
• 测试: Vitest

🔮 路线图

Phase 3 ✅

• [x] 三级缓存架构
• [x] 自动进化系统
• [x] 知识系统管理器

Phase 4 ✅

• [x] iflow 适配器
• [x] Cursor 适配器
• [x] 快速启动功能
• [x] MCP 服务器实现

Phase 5 (计划中)

• [ ] 文档网站
• [ ] 性能优化
• [ ] 更多团队模板

❓ 常见问题

Q: HIVE 需要什么环境？

A: Node.js 20+ 即可，支持 Windows、macOS、Linux。

Q: 支持哪些 IDE？

A: 目前支持 Cursor、Claude Desktop 和 iflow CLI IDE，未来会支持更多支持 MCP 的 IDE。

Q: 如何验证 HIVE 是否安装成功？

A: 在 IDE 聊天界面中说"列出所有模板"，如果 AI 能调用 HIVE 工具并返回模板列表，说明安装成功。

Q: 团队模板可以自定义吗？

A: 目前提供 10 种预设模板，基本覆盖所有常见场景。如需特殊配置，可以在创建团队时向 AI 说明具体需求。

Q: 可以同时运行多个团队吗？

A: 可以，每个团队独立运行，互不干扰。

Q: 知识系统的数据存储在哪里？

A: 默认存储在 .hive/knowledge.db SQLite 数据库中。

🤝 贡献

欢迎提交 Issue 和 Pull Request！

贡献指南

1. Fork 本仓库
2. 创建特性分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 开启 Pull Request

📄 许可证

MIT License

🙏 致谢

感谢所有贡献者和使用者！

特别感谢：

• Anthropic Claude - AI 能力支持
• Model Context Protocol - 标准协议支持
• TypeScript 社区
• Node.js 社区

让 AI 团队协作更智能、更高效！ 🚀

在 IDE 中用自然语言指挥 AI 团队，HIVE 让多 Agent 协作触手可及！