Geekbot

🚀 機器人 MCP 服務器

解鎖您的 Geekbot 數據以用於 LLM 應用程序中 🚀

機器人 MCP 服務器作為 Geekbot 與 LLM 客戶端應用程序（如 Claude）之間的橋樑，讓您能夠輕鬆訪問和管理團隊在 Geekbot 中共享的站會數據。

🚀 快速開始

安裝

使用 pip 安裝

pip install geekbot-mcp

配置

初始化 MCP 服務

geekbot-mcp init

啟動 MCP 服務器

geekbot-mcp serve

✨ 主要特性

工具

1. 站會成員列表工具

• 用途：列出您 Geekbot 工作區的所有團隊成員。
• 返回參數：
  • id（字符串）：成員的唯一標識符。
  • name（字符串）：成員的全名。
  • email（字符串）：成員的電子郵件地址。
  • role（字符串）：成員在 Geekbot 中的角色（例如，管理員、普通成員）。

2. 站會報告列表工具

• 用途：獲取指定站會的所有報告內容。
• 參數：
  • standup_id（字符串）：要獲取報告的站會 ID。
  • before（日期字符串，可選）：過濾在指定日期之前的報告（格式為 YYYY - MM - DD）。
  • after（日期字符串，可選）：過濾在指定日期之後的報告（格式為 YYYY - MM - DD）。
• 返回參數：
  • id（字符串）：報告的唯一標識符。
  • reporter_name（字符串）：提交報告的成員姓名。
  • reporter_id（字符串）：提交報告的成員 ID。
  • standup_id（字符串）：關聯站會的 ID。
  • created_at（日期時間字符串）：報告創建的時間戳。
  • content（字符串）：報告中的具體回答或內容。

3. 站會生成周報工具

• 用途：根據指定站會的數據生成周報，包含團隊更新、風險與應對策略、下一步計劃和即將上線的功能等內容。
• 參數：
  • standup_id（字符串）：要生成周報的站會 ID。

指令

1. 團隊成員指令

• 示例提示："請列出我的 Geekbot 工作區的所有團隊成員。"
• 輸出格式：

{
  "members": [
    {
      "id": "string",
      "name": "string",
      "email": "string",
      "role": "string"
    }
  ]
}

2. 站會報告指令

• 示例提示："請提供今天所有站會的報告內容，格式為 JSON。"
• 輸出格式：

{
  "reports": [
    {
      "id": "string",
      "reporter_name": "string", 
      "reporter_id": "string",
      "standup_id": "string",
      "created_at": "datetime string",
      "content": "string"
    }
  ]
}

3. 週報生成指令

• 示例提示："請為站會 ID 123 生成一份週報，內容包括團隊更新、風險與應對策略、下一步計劃和即將上線的功能。"
• 輸出格式：

{
  "weekly_report": {
    "summary": "string", // 團隊更新的摘要
    "key_highlights": ["string"], // 關鍵亮點列表
    "risks_and Mitigations": [
      {
        "risk": "string",
        "mitigation": "string"
      }
    ],
    "next_steps": ["string"], // 下一步計劃列表
    "upcoming_launches": ["string"] // 即將上線的功能列表
  }
}

📦 安裝指南

使用 pip 安裝

pip install geekbot-mcp

💻 使用示例

開發

克隆倉庫

git clone https://github.com/geekbot-com/geekbot-mcp.git
cd geekbot-mcp

安裝依賴項

pip install -r requirements.txt

運行測試

pytest tests/

🤝 貢獻

歡迎貢獻！請 fork 倉庫並提交 Pull Request。

📄 許可證

本項目使用 MIT 許可證，詳情請查看 LICENSE 文件。

🙏 致謝

• 基於 Anthropic 的模型上下文協議 框架構建。
• 使用官方 Geekbot API 開發。