🚀 鸭子团队（GooseTeam）项目说明

这是一个专注于创建协作型 AI 团队的应用项目。借助大型语言模型（LLM），该项目能够实现多任务处理、流程自动化以及复杂的决策过程，为需要多步骤处理和决策的应用场景提供了强大的支持。

🚀 快速开始

启动 MCP 代理

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

运行 inspector 检查工具

npm run inspector

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

服务器启动命令

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

✨ 主要特性

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

📦 安装指南

本项目通过 npm 命令来完成各项操作，以下是具体的启动和检查步骤：

启动 MCP 代理

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

运行 inspector 检查工具

npm run inspector

打开浏览器，访问 http://localhost:5173，设置传输类型为 SSE，URL 为 http://localhost:3001/sse，然后点击连接按钮。

服务器启动

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

💻 使用示例

基础用法

启动代理

npm run agent:text # 使用文本协议启动代理
npm run agent:chart # 使用图表协议启动代理

运行检查工具

npm run inspector

启动服务器

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

高级用法

测试代理等待循环能力

npm run agent:wait:test # 测试代理的等待循环能力

📚 详细文档

工具说明

检查工具（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 和他的演讲视频。