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 开发。