Geekbot MCP

在你的 LLM 申请中解锁你的 Geekbot 数据🚀

Geekbot MCP（模型上下文协议）服务器充当桥梁，将 LLM 客户端应用程序（例如 Claude）直接连接到您的 Geekbot 工作区。这使您可以使用自然语言在对话中与站立会议、报告和团队成员无缝交互。

主要特点✨

• 访问站立会议信息：列出 Geekbot 工作区中的所有站立会议。📊
• 检索站立会议报告：使用特定站立会议、用户或日期范围的过滤器获取报告。📄
• 查看团队成员：获取您在 Geekbot 中合作的成员列表。👥

安装💻

需要 Python 3.10+ 和uv 。

1. 安装 uv（如果还没有安装）：
   curl -LsSf https://astral.sh/uv/install.sh | sh
   （更多选项请参阅uv 安装文档。）
2. 安装 Geekbot MCP：
   uv tool install geekbot-mcp

升级⬆️

要更新到最新版本：

配置⚙️

将 Geekbot MCP 连接到你的 LLM（例如 Claude Desktop）：

1. **获取您的 Geekbot API 密钥：**在您的Geekbot API/Webhooks 设置中找到它🔑。
2. 找到您的uv可执行路径：
   which uv
3. **配置你的 LLM 客户端应用程序：**编辑你的claude_desktop_config.json （或其他 MCP 客户端的等效配置文件）以添加 Geekbot MCP 服务器
   { "globalShortcut": "", "mcpServers": { // Add or update this section "geekbot-mcp": { "command": "<path-returned-by-which-uv>", // Replace with your actual uv path "args": [ "tool", "run", "geekbot-mcp" ], // Environment variables needed by the server "env": { "GB_API_KEY": "<your-geekbot-api-key>" // Replace with your actual API key } } // ... other MCP servers if any } // ... other configurations }
   （有关客户端配置的更多详细信息，请参阅MCP 快速入门。）

使用方法💡

配置完成后，您的 LLM 客户端应用程序将可以访问以下工具并提示与您的 Geekbot 数据进行交互：

工具🛠️

• list_standups

**用途：**列出所有可通过 API 密钥访问的站立会议。可用于概览或查找特定的站立会议 ID。

示例提示： “嘿，你能列出我的 Geekbot 站立会议吗？”

返回的数据字段：

• id ：唯一站立标识符。
• name ：站立会议的名称。
• channel ：相关通信渠道（例如，Slack 渠道）。
• time ：站立报告的预定时间。
• timezone ：预定时间的时区。
• questions ：站立会议上提出的问题列表。
• participants ：参与站立会议的用户列表。
• owner_id ：站立会议所有者的 ID。
• fetch_reports

**用途：**检索特定的站立会议报告。您可以按站立会议、用户和日期范围进行筛选。

示例提示：

• “获取昨天提交的回顾报告。”
• “显示用户 John Doe 的‘每周同步’站立会议报告。”
• “获取 2024 年 6 月 1 日之后提交给每日站立会议的所有报告。”

可用的过滤器：

• standup_id ：按特定的站立 ID 进行过滤。
• user_id ：按特定用户 ID 过滤报告。
• after ：检索此日期 (YYYY-MM-DD) 之后提交的报告🗓️。
• before ：检索在此日期之前提交的报告（YYYY-MM-DD）🗓️。

返回的数据字段：

• id ：唯一报告标识符。
• reporter_name ：提交报告的用户的姓名。
• reporter_id ：提交报告的用户的 ID。
• standup_id ：报告所属站立会议的 ID。
• created_at ：提交报告的时间戳。
• content ：报告的实际答案/内容。
• list_members

**目的：**列出您在 Geekbot 工作区中共享站立会议的所有团队成员。

示例提示： “我的 Geekbot 工作区中有哪些成员？”

返回的数据字段：

• id ：唯一会员标识符。
• name ：会员的全名。
• email ：会员的电子邮件地址。
• role ：成员在 Geekbot 中的角色（例如，管理员、成员）。

提示💬

• weekly_rollup_report

**目的：**生成一份全面的每周汇总报告，总结团队站立反应、强调关键更新、识别风险和缓解策略、概述后续步骤并跟踪即将发布的产品。

参数：

• standup_id ：要包含在汇总报告中的站立会议的 ID。

开发🧑‍💻

有兴趣贡献或本地运行服务器吗？

设置开发环境

运行测试✅

贡献🤝

欢迎贡献代码！请 fork 代码库并提交 Pull 请求，包含你的修改。

许可证📜

该项目已获得MIT 许可。

致谢🙏

• 建立在人择模型上下文协议框架之上。
• 利用官方的Geekbot API 。