AI导哈

Geekbot MCP服务器

Geekbot MCP服务器是一个连接LLM客户端应用程序与Geekbot工作空间的桥梁，支持通过自然语言交互访问和管理站会、报告及团队成员信息。

  • by geekbot-com
  • Python
  • 本地部署
  • 22 星标
  • 更新于
在 GitHub 查看 geekbot-com/geekbot-mcp

使用说明

Geekbot MCP

[！重要]

⚠️ 此项目不再维护，已存档

此本地自行安装的MCP服务器的开发已停止。我们已经搬到了 远程、OAuth认证的Geekbot MCP服务器 它不需要本地安装，配置文件中不需要API密钥，并自动保持最新。

改为使用什么：

  • Geekbot远程MCP服务器： 通过远程MCP服务器将您的AI助手连接到Geekbot。 → 安装指南
  • Geekbot CLI和AI技能： 从您的终端或AI编码代理（Claude Code、Cursor、Windsurf、Copilot）提交报告、分析过去的回复并管理站立和投票。 → github/geekbot-com/geekbot-cli

此存储库保持可用、只读，以供参考。以下说明仅供历史参考，不再受支持。

在LLM应用程序中解锁Geekbot数据🚀

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

主要特点✨

  • 访问站立和投票信息：列出Geekbot工作区中的所有站立和投票。 📊
  • 检索站立报告和民意调查结果：使用针对特定站立、用户或日期范围的筛选器获取报告和民意调查结果。 📄
  • 查看团队成员：获取您在Geekbot中合作的成员列表。 👥
  • 站立后报告：向Geekbot发布站立报告。 📝

查看视频：

安装💻

手动安装

需要Python 3.10+和 uv.

  1. 安装Python 3.10+（如果你还没有）：

  2. 安装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"

    （参见 紫外线安装文档 更多选择。)

  3. 安装/升级Geekbot MCP：

    • macOS/Linux： 在您的终端中，运行以下命令：

      uv tool install --upgrade geekbot-mcp

    • 窗户： 在PowerShell中，运行以下命令：

      uv tool install --upgrade geekbot-mcp

配置⚙️

安装Geekbot MCP后，您可以将其连接到LLM客户端桌面应用程序（例如，Claude desktop、Cursor、Windsurf等）：

  1. 获取Geekbot API密钥： 在你的 Geekbot API/Webhooks设置 🔑.

  2. 找到你的 uv 可执行路径：

  • Linux/macOS： 在您的终端中，运行以下命令：

      which uv

  • 窗户： 在PowerShell中，运行以下命令：

      (Get-Command uv | Select-Object -ExpandProperty Path) -replace '\\', '\\'
  1. 配置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许可证.

致谢🙏

相关 MCP