Geekbot MCP

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

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

主要特点✨

• 访问站立会议和民意调查信息：列出 Geekbot 工作区中的所有站立会议和民意调查。📊

• 检索站立会议报告和投票结果：使用特定站立会议、用户或日期范围的过滤器获取报告和投票结果。📄

• 查看团队成员：获取您在 Geekbot 中合作的成员列表。👥

• 发布站立报告：向 Geekbot 发布站立报告。📝

Related MCP server: Notion MCP Server

安装💻

通过 Smithery 安装

要通过Smithery安装 Geekbot MCP 作为远程服务器：

npx -y @smithery/cli install @geekbot-com/geekbot-mcp --client claude

远程服务器将随着每次发布自动更新到最新版本。

有关Smithery 数据政策的更多信息

手动安装

需要 Python 3.10+ 和uv 。

1. 安装 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 安装指南。

2. 安装 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 安装文档。）

3. 安装/升级 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 等）：

1. **获取您的 Geekbot API 密钥：**在您的Geekbot API/Webhooks 设置中找到它🔑。

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

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

    which uv

• **Windows：**在 PowerShell 中，运行以下命令：

    (Get-Command uv | Select-Object -ExpandProperty Path) -replace '\\', '\\'

3. **配置您的 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为步骤 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。

开发🧑‍💻

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

设置开发环境

# 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

贡献🤝

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

许可证📜

该项目已获得MIT 许可。

致谢🙏

• 建立在人择模型上下文协议框架之上。

• 利用官方的Geekbot API 。