Geekbot MCP
   ](https://badge.fury.io/py/geekbot-mcp) ](https://smithery.ai/server/@geekbot-com/geekbot-mcp) 
在LLM应用程序中解锁Geekbot数据🚀
Geekbot MCP（模型上下文协议）服务器充当桥梁，将LLM客户端应用程序（如Claude、Cursor、Windsurf等）直接连接到您的Geekbot工作区。这允许您在对话中使用自然语言与您的单口相声、报告和团队成员无缝交互。
主要特点✨
- 访问站立和投票信息：列出Geekbot工作区中的所有站立和投票。 📊
- 检索站立报告和民意调查结果：使用针对特定站立、用户或日期范围的筛选器获取报告和民意调查结果。 📄
- 查看团队成员：获取您在Geekbot中合作的成员列表。 👥
- 站立后报告：向Geekbot发布站立报告。 📝
查看视频：
安装💻
通过Smithery安装
通过以下方式将Geekbot MCP安装为远程服务器 史密瑟里:
npx -y @smithery/cli install @geekbot-com/geekbot-mcp --client claude每次发布时，远程服务器都会自动更新到最新版本。
更多信息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- 窗户： 从下载并安装 Python.org.
看 Windows Python安装指南 了解更多详情。
- 安装uv（如果你还没有）：
- macOS/Linux： 在您的终端中，运行以下命令：
curl -LsSf https://astral.sh/uv/install.sh | sh- 窗户： 在PowerShell中，运行以下命令：
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"（参见 紫外线安装文档 更多选择。)
- 安装/升级Geekbot MCP：
- macOS/Linux： 在您的终端中，运行以下命令：
uv tool install --upgrade geekbot-mcp- 窗户： 在PowerShell中，运行以下命令：
uv tool install --upgrade geekbot-mcp配置⚙️
安装Geekbot MCP后，您可以将其连接到LLM客户端桌面应用程序（例如，Claude desktop、Cursor、Windsurf等）：
- 获取Geekbot API密钥： 在你的 Geekbot API/Webhooks设置 🔑.
- 找到你的
uv可执行路径：
- Linux/macOS：
在您的终端中，运行以下命令：
which uv- 窗户：
在PowerShell中，运行以下命令：
(Get-Command uv | Select-Object -ExpandProperty Path) -replace '\\', '\\'- 配置LLM客户端桌面应用程序：
每个支持MCP的LLM客户端都提供了一个配置文件，您可以编辑该文件以添加Geekbot MCP服务器。
如果您使用的是其他LLM客户端，请参阅客户端的文档以了解如何配置MCP服务器。
找到配置文件后，编辑它以添加Geekbot MCP服务器：
{
"mcpServers": {
"geekbot-mcp": {
"command": "UV-PATH",
"args": [
"tool",
"run",
"geekbot-mcp"
],
"env": {
"GB_API_KEY": "YOUR-API-KEY"
}
}
}
}确保更换：
UV-PATH通往你的路uv可从步骤2执行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。
发展🧑💻
有兴趣在本地贡献或运行服务器吗？
设置开发环境
# 1. Clone the repository
git clone https://github.com/geekbot-com/geekbot-mcp.git
cd geekbot-mcp
# 2. Install uv (if needed)
# curl -LsSf https://astral.sh/uv/install.sh | sh
# 3. Create a virtual environment and install dependencies
uv sync运行测试✅
# Ensure dependencies are installed (uv sync)
pytest贡献🤝
欢迎投稿！请分叉存储库，并提交一个包含您的更改的Pull Request。
许可证📜
该项目根据 MIT许可证.
致谢🙏
- 建在 人类模型上下文协议 框架。
- 利用官方 Geekbot API.