Gooseteam

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

这是一个专注于创建协作型AI团队的应用项目。借助大型语言模型（LLM），可实现多任务处理、流程自动化以及复杂决策过程，为相关应用场景提供强大助力。

🚀 快速开始

启动 MCP 代理

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

运行 inspector 检查工具

npm run inspector

操作步骤如下：

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

服务器启动命令

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

✨ 主要特性

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

📦 安装指南

此文档未提及具体安装步骤，若有相关需求，请进一步查阅项目相关资源。

💻 使用示例

基础用法

以下是启动 MCP 代理的基础代码示例：

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

高级用法

运行 inspector 检查工具并进行相关配置，可实现对代理的监控和管理：

npm run inspector

操作步骤：

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

📚 详细文档

工具说明

检查工具（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）实现多任务处理、流程自动化以及复杂决策过程。通过不同协议启动AI代理，支持多种服务器配置，并提供 inspector 工具进行监控和管理。同时，包含等待循环测试来评估模型的持续交互能力。

📄 注意事项

⚠️ 重要提示

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

📚 链接与资源

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

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