鸭子团队（GooseTeam）项目说明

项目概述

这是一个关于创建协作型AI团队的应用项目。通过使用大型语言模型（LLM），可以实现多任务处理、流程自动化以及复杂的决策过程。

核心功能

• 代理启动：可以通过不同的协议启动多个AI代理。
• 服务器配置：支持多种服务器配置，包括直接SSE和代理模式。
• 工具检查：提供 inspector 工具用于监控和管理代理。
• 流程测试：包含等待循环测试来评估模型的持续交互能力。

快速上手指南

1. 启动 MCP 代理：

   npm run agent:text # 使用文本协议启动代理
   npm run agent:chart # 使用图表协议启动代理
   npm run agent:wait:test # 测试代理的等待循环能力
   

2. 运行 inspector 检查工具：

   npm run inspector
   

   • 打开 Inspector UI：http://localhost:5173
   • 设置传输类型为 SSE
   • 设置 URL 为 http://localhost:3001/sse
   • 点击连接按钮

3. 服务器启动命令：

   npm run sse:direct # 启动直接SSE服务器
   npm run sse:proxy # 启动代理SSE服务器
   

工具说明

检查工具（Inspector）

• 运行 npm run inspector 启动检查工具。
• UI 界面提供多种功能：
  • 连接服务器：设置正确的传输类型和 URL，点击连接按钮。
  • 列表工具：查看当前可用工具及其状态。
  • 监控资源：实时监控代理的交互情况。

代理协议

文本协议（agent:text）

• 使用 instructions/protocol-as-text.md 中的文本说明启动代理。
• 第一个代理自动承担项目协调员角色。

图表协议（agent:chart）

• 使用 instructions/protocol-as-chart.md 中的图表说明启动代理。
• 该协议使用 Mermaid 格式，适合技术背景的用户。

等待循环测试（agent:wait:test）

• 测试代理是否能够保持消息检查的循环状态。
• 如果出现队列为空错误，则模型不适合用于团队协作。

格式化与代码规范

npm run format # 使用 Prettier 格式化代码
npm run typecheck # 运行 TypeScript 类型检查
npm run lint # 执行 ESLint 代码检查
npm run lint:fix # 自动修复代码问题

单元测试

npm test # 运行单元测试套件

注意事项

• 服务器配置：运行代理之前确保服务器已经启动。
• 模型选择：推荐使用经过验证的 LLM 模型，如 GooseTeam 团队验证过的模型。
• 环境要求：请在支持 SSE 的环境中运行项目。

链接与资源

• MCP 规范：完整的 Model Context Protocol 规范可在此查阅。
• 服务器参考：采用简单但模块化的 GitHub 示例作为开发参考。
• 灵感来源：基于 Aaron Goldsmith 的 Gist 和他的演讲视频。

此项目旨在通过 AI 代理实现复杂的协作任务，适用于需要多步骤处理和决策的应用场景。