使用说明

项目简介

Geekbot MCP Server 是一个基于 Model Context Protocol (MCP) 构建的应用后端，旨在将 Geekbot 的强大站会、投票和调查管理工具与 Anthropic 的 Claude AI 无缝集成。通过此服务器，Claude AI 可以访问您的 Geekbot 数据，并利用预设的工具在对话中获取上下文信息，从而实现更智能的交互。

主要功能点

站会信息检索: 允许 Claude AI 获取 Geekbot 中所有站会的信息，例如站会的名称、时间、参与者和问题等。
报告检索: 允许 Claude AI 根据多种条件（如站会 ID、用户 ID、日期范围）检索站会报告，获取团队成员在站会中的回复内容。

安装步骤

安装 uv 包管理器: 按照仓库 README.md 中的指引，首先安装 'uv' 包管理器。'uv' 是一个快速的 Python 包安装和管理工具，可以显著提升安装速度。
```
curl -LsSf https://astral.sh/uv/install.sh | sh
```
更多 'uv' 安装信息请参考 uv 文档

克隆仓库: 使用 Git 克隆 'geekbot-mcp' 仓库到本地。

git clone https://github.com/geekbot-com/geekbot-mcp.git
cd geekbot-mcp

安装项目: 使用 'uv tool install' 命令安装项目依赖并使其可编辑。

uv tool install --editable .

服务器配置

要使 MCP 客户端（例如 Claude AI 客户端）能够连接到 Geekbot MCP Server，您需要在客户端的配置文件 'claude_desktop_config.json' 中添加服务器配置信息。

获取 Geekbot API Key: 访问 Geekbot API 密钥管理页面获取您的 Geekbot API Key。

配置 'claude_desktop_config.json': 在 'claude_desktop_config.json' 文件中，'mcpServers' 字段下添加 'geekbot-mcp' 服务器的配置。

{
  "globalShortcut": "",
  "mcpServers": {
    "geekbot-mcp": {
      "command": "<uv executable 路径>",
      "args": [
        "tool",
        "run",
        "geekbot-mcp"
      ],
      "env": {
        "GB_API_KEY": "<您的 Geekbot API Key>"
      }
    }
  }
}

'command': 需要替换为 'uv' 可执行文件的路径。您可以使用 'which uv' 命令在终端中查找 'uv' 的路径。
'args': 保持不变，'["tool", "run", "geekbot-mcp"]' 指示使用 'uv tool run' 运行 'geekbot-mcp' 工具，即启动 MCP 服务器。
'env': 'GB_API_KEY' 环境变量需要设置为您的 Geekbot API Key，用于服务器访问 Geekbot API。

请注意： MCP 客户端只需要 'command' 和 'args' 来启动 MCP 服务器，以及 'env' 环境变量配置。无需修改 'server.py' 等服务器端代码。

基本使用方法

配置完成后，当您在 Claude AI 中与机器人对话时，Claude AI 将能够：

使用 'fetch_standups' 工具获取站会列表。
使用 'fetch_reports' 工具并指定参数（如站会 ID、日期等）来检索站会报告。
利用 'weekly_update_rollup_report' Prompt 模板生成每周更新汇总报告。

您可以在 Claude AI 的对话中指示其使用这些工具来获取 Geekbot 数据，例如：

"帮我获取所有站会的列表" (Claude AI 可能会调用 'fetch_standups' 工具)。
"请获取 ID 为 1 的站会的最新报告" (Claude AI 可能会调用 'fetch_reports' 工具并设置 'standup_id=1')。
"使用每周更新汇总报告模板，为站会 ID 2 生成一份报告" (Claude AI 可能会使用 'weekly_update_rollup_report' Prompt 模板并调用 'fetch_reports' 获取数据)。

通过这些工具和模板，Claude AI 可以更深入地理解您的 Geekbot 数据，并在对话中提供更相关和有价值的回复。

关键词