Beeminder MCP Server 使用说明

项目简介

Beeminder MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，它允许大型语言模型 (LLM) 客户端（如 Claude Desktop）通过标准化的 MCP 协议与 Beeminder 服务进行交互。该服务器作为 LLM 和 Beeminder API 之间的桥梁，使得用户可以通过自然语言指令，让 LLM 助手帮助管理 Beeminder 目标、记录数据点、查询用户信息等。

主要功能点

目标管理：支持创建、读取、更新和删除 Beeminder 目标。
数据点管理：支持创建、读取和删除 Beeminder 目标的数据点。
用户信息检索：获取 Beeminder 用户信息。
支持多种目标类型：涵盖 Beeminder 的所有目标类型，如 Do More, Odometer, Weight Loss 等。
数据以 JSON 格式返回：方便 LLM 客户端解析和使用。

安装步骤

克隆仓库

git clone https://github.com/strickvl/mcp-beeminder.git
cd mcp-beeminder

配置 Claude Desktop (或其他 MCP 客户端) (以 Claude Desktop 为例)
- 找到 'claude_desktop_config.json' 配置文件：
  - MacOS: '~/Library/Application\ Support/Claude/claude_desktop_config.json'
  - Windows: '%APPDATA%/Claude/claude_desktop_config.json'
- 在 'claude_desktop_config.json' 文件中，将以下 JSON 配置添加到 '"mcpServers"' 字段中。如果 'mcpServers' 字段不存在，则创建它。
```
"mcpServers": {
  "beeminder": {
    "command": "uv",
    "args": [
      "--directory",
      "/path/to/repo/mcp-beeminder", //  替换为你的 mcp-beeminder 仓库的绝对路径
      "run",
      "mcp-beeminder"
    ],
    "env": {
        "BEEMINDER_API_KEY": "YOUR_BEEMINDER_API_KEY", // 替换为你的 Beeminder API 密钥
        "BEEMINDER_USERNAME": "YOUR_BEEMINDER_USERNAME" // 替换为你的 Beeminder 用户名
    }
  }
}
```
  参数说明:
  - '"beeminder"': 服务器名称，可以自定义，用于在 Claude Desktop 中标识和调用。
  - '"command": "uv"': 启动服务器的命令，这里使用 'uv' (一个快速的 Python 包安装和运行工具)。你需要确保已安装 'uv'。如果你使用其他工具（如 'python'），请相应修改此命令。
  - '"args"': 传递给 'command' 的参数列表：
    - '"--directory"': 指定工作目录为 mcp-beeminder 仓库的路径。 请务必将 '/path/to/repo/mcp-beeminder' 替换为你实际的仓库路径。
    - '"run"': 'uv run' 命令用于运行 Python 模块。
    - '"mcp-beeminder"': 指定要运行的 Python 模块名称，这里指向 'mcp_beeminder' 模块，即 'src/mcp_beeminder/server.py' 文件。
  - '"env"': 环境变量配置：
    - '"BEEMINDER_API_KEY"': 必须替换为你的 Beeminder API 密钥。 你可以在 https://www.beeminder.com/api/v1/auth_token.json 页面获取。
    - '"BEEMINDER_USERNAME"': 必须替换为你的 Beeminder 用户名。
安装 Claude Desktop 应用
- 前往 https://claude.ai/download 下载并安装 Claude Desktop 应用。
启动 Claude Desktop 应用
- 确保 Claude Desktop 应用已启动并运行。

基本使用方法

配置完成后，你可以通过 Claude Desktop 应用与 Beeminder MCP Server 进行交互。

与 Claude 对话：在 Claude Desktop 中，你可以像正常对话一样提问，例如：
- "List my Beeminder goals." (列出我的 Beeminder 目标)
- "Create a Beeminder goal named 'daily-coding' to code for 1 hour per day." (创建一个名为 'daily-coding' 的 Beeminder 目标，每天编码 1 小时)
- "Add a datapoint with value 1 to my 'daily-coding' goal for today." (为我的 'daily-coding' 目标添加一个值为 1 的今日数据点)
利用 LLM 理解自然语言指令： Claude (或其他 MCP 客户端) 会将你的自然语言指令转换为对 Beeminder MCP Server 的 MCP 请求，服务器会调用相应的 Beeminder API 功能，并将结果返回给 Claude，最终以自然语言形式呈现给你。

注意:

首次使用前，请务必正确配置 'claude_desktop_config.json' 文件中的 'command'、'args' 和 'env' 字段，尤其是 'BEEMINDER_API_KEY' 和 'BEEMINDER_USERNAME' 环境变量。
确保你的 Beeminder API 密钥和用户名正确无误。
如果遇到问题，请参考 MCP 官方文档的调试工具进行问题排查 (https://modelcontextprotocol.io/docs/tools/debugging)。

关键词

Beeminder MCP Server 使用说明

项目简介

主要功能点

安装步骤

基本使用方法

信息