Geekbot MCP
在你的 LLM 申请中解锁你的 Geekbot 数据🚀
Geekbot MCP(模型上下文协议)服务器充当桥梁,将 LLM 客户端应用程序(例如 Claude、Cursor、Windsurf 等)直接连接到您的 Geekbot 工作区。这使您可以使用自然语言在对话中与站立会议、报告和团队成员无缝交互。
主要特点✨
访问站立会议和民意调查信息:列出 Geekbot 工作区中的所有站立会议和民意调查。📊
检索站立会议报告和投票结果:使用特定站立会议、用户或日期范围的过滤器获取报告和投票结果。📄
查看团队成员:获取您在 Geekbot 中合作的成员列表。👥
发布站立报告:向 Geekbot 发布站立报告。📝
Related MCP server: MCP Gemini Server
安装💻
通过 Smithery 安装
要通过Smithery安装 Geekbot MCP 作为远程服务器:
远程服务器将随着每次发布自动更新到最新版本。
有关Smithery 数据政策的更多信息
手动安装
需要 Python 3.10+ 和uv 。
安装 Python 3.10+(如果尚未安装):
macOS:
brew install python@3.10有关更多详细信息,请参阅Homebrew Python 安装指南。
Ubuntu/Debian:
sudo apt update sudo apt install python3.10**Windows:**从Python.org下载并安装。
有关更多详细信息,请参阅Windows Python 安装指南。
安装 uv(如果还没有安装):
**macOS/Linux:**在您的终端中,运行以下命令:
curl -LsSf https://astral.sh/uv/install.sh | sh**Windows:**在 PowerShell 中,运行以下命令:
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
(更多选项请参阅uv 安装文档。)
安装/升级 Geekbot MCP:
**macOS/Linux:**在您的终端中,运行以下命令:
uv tool install --upgrade geekbot-mcp**Windows:**在 PowerShell 中,运行以下命令:
uv tool install --upgrade geekbot-mcp
配置⚙️
安装 Geekbot MCP 后,您可以将其连接到 LLM 客户端桌面应用程序(例如,Claude Desktop、Cursor、Windsurf 等):
**获取您的 Geekbot API 密钥:**在您的Geekbot API/Webhooks 设置中找到它🔑。
找到您的
**Linux/macOS:**在您的终端中,运行以下命令:
which uv**Windows:**在 PowerShell 中,运行以下命令:
(Get-Command uv | Select-Object -ExpandProperty Path) -replace '\\', '\\'
**配置您的 LLM 客户端桌面应用程序:**每个支持 MCP 的 LLM 客户端都提供一个配置文件,您可以编辑该文件以添加 Geekbot MCP 服务器。
如果您使用不同的 LLM 客户端,请参阅客户端的文档以了解如何配置 MCP 服务器。
找到配置文件后,编辑它以添加 Geekbot MCP 服务器:
确保替换:
UV-PATH为步骤 2 中uv可执行文件的路径YOUR-API-KEY为您在步骤 1 中得到的 Geekbot API 密钥
使用方法💡
配置完成后,您的 LLM 客户端应用程序将可以访问以下工具并提示与您的 Geekbot 数据进行交互:
工具🛠️
list_standups
**用途:**列出所有可通过 API 密钥访问的站立会议。可用于概览或查找特定的站立会议 ID。
示例提示: “嘿,你能列出我的 Geekbot 站立会议吗?”
返回的数据字段:
id:唯一站立标识符。name:站立会议的名称。channel:相关通信渠道(例如,Slack 渠道)。time:站立报告的预定时间。timezone:预定时间的时区。questions:站立会议上提出的问题列表。participants:参与站立会议的用户列表。owner_id:站立会议所有者的 ID。confidential:站立会议是否保密。anonymous:站立会议是否匿名。
list_polls
**用途:**列出所有可通过 API 密钥访问的投票。可用于概览或查找特定的投票 ID。
示例提示: “嘿,你能列出我的 Geekbot 民意调查吗?”
返回的数据字段:
id:唯一轮询标识符。name:投票的名称。time:投票的预定时间。timezone:预定时间的时区。questions:民意调查中提出的问题列表。participants:参与投票的用户列表。creator:投票创建者。
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:报告的实际答案/内容。
post_report
**目的:**向 Geekbot 发布报告。
提示示例: “嘿,你能发布每日站立会议的报告吗?”
返回的数据字段:
id:唯一报告标识符。reporter_name:提交报告的用户的姓名。reporter_id:提交报告的用户的 ID。standup_id:报告所属站立会议的 ID。created_at:提交报告的时间戳。content:报告的实际答案/内容。
list_members
**目的:**列出您在 Geekbot 工作区中共享站立会议的所有团队成员。
示例提示: “我的 Geekbot 工作区中有哪些成员?”
返回的数据字段:
id:唯一会员标识符。name:会员的全名。email:会员的电子邮件地址。role:成员在 Geekbot 中的角色(例如,管理员、成员)。
fetch_poll_results
**目的:**检索特定的投票结果。需要投票 ID 以及可选的日期范围。
示例提示: “嘿,Geekbot 民意调查中关于新徽标的决定是什么?”
返回的数据字段:
total_results:结果总数。question_results:问题结果列表。
提示💬
weekly_rollup_report
**目的:**生成一份全面的每周汇总报告,总结团队站立反应、强调关键更新、识别风险和缓解策略、概述后续步骤并跟踪即将发布的产品。
提示💡
审核工具使用情况:让代理在执行每个工具操作时都请求您的明确批准,并且不允许自动调用工具。此安全功能可确保您控制敏感操作,尤其是在向 Geekbot 发布报告时。系统会在执行每个工具调用之前提示您审核并批准,从而有助于防止意外的数据提交。
请求预览:在发布报告之前,请客服人员预览报告,而不是直接发布。这样,您就有机会在将报告发布到 Geekbot 之前,仔细检查报告,确保其正确无误,或者进行修改。
限制检索的数据量:如果您使用
fetch_reports工具,请将日期范围限制在合理的范围内。这有助于防止代理检索大量数据并导致性能问题。请注意,代理会限制其可检索的报告数量。
参数:
standup_id:要包含在汇总报告中的站立会议的 ID。
开发🧑💻
有兴趣贡献或本地运行服务器吗?
设置开发环境
运行测试✅
贡献🤝
欢迎贡献代码!请 fork 代码库并提交 Pull 请求,包含你的修改。
许可证📜
该项目已获得MIT 许可。
致谢🙏
建立在人择模型上下文协议框架之上。
利用官方的Geekbot API 。