Gooseteam

🚀 鴨子團隊（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 和他的演講視頻。