MCP Beeminder Server

该项目实现了一个模型上下文协议（MCP）服务器，用于与Beeminder API进行交互。

什么是MCP？

模型上下文协议（MCP）是一个开放协议，标准化了应用程序如何向大型语言模型（LLMs）提供上下文。它就像“AI应用的USB-C端口”——提供了一种标准化的方式，将AI模型连接到不同的数据源和工具上。

MCP遵循客户端-服务器架构，其中：

• MCP主机：想要通过MCP访问数据的程序，如Claude Desktop或IDE。
• MCP客户端：维护与服务器一对一连接的协议客户端。
• MCP服务器：轻量级程序，通过标准协议暴露特定能力。
• 本地数据源：MCP服务器可以安全访问的计算机文件、数据库和服务。
• 远程服务：MCP服务器可以通过互联网连接的外部系统。

什么是Beeminder？

Beeminder是一款工具，通过结合以下内容来克服拖延症（即违背自己的判断行事）：

• 自我量化跟踪
• 通过“亮红色线”（BRL）显示承诺路径的视觉反馈
• 随着每次失败而增加的经济风险
• 具有7天“拖延视野”的灵活承诺

此服务器实现提供了与Beeminder API兼容的访问，允许AI助手帮助用户管理他们的Beeminder目标、数据点和其他相关功能。

功能

该服务器提供了对核心Beeminder功能的访问，包括：

• 目标管理（创建、读取、更新、删除）
• 数据点管理（创建、读取、删除）
• 用户信息检索
• 支持所有Beeminder目标类型：
  • 做更多（“努力者”）
  • 计数器（“骑行者”）
  • 减肥（“减肥者”）
• 增加体重（“增重者”）
• 减少收件箱（“收件箱者”）
• 做更少（“饮酒者”）

在本地运行与Claude Desktop应用

先决条件

你需要Beeminder API密钥和用户名才能运行服务器。获取API密钥的方法如下：

1. 登录Beeminder
2. 转到https://www.beeminder.com/api/v1/auth_token.json

你也需要安装uv。查看uv文档以获取安装说明。你可以使用其他工具，但你需要更改claude_desktop_config.json文件中的command。

手动安装

1. 克隆这个仓库。
2. 将以下内容添加到你的claude_desktop_config.json文件中：

• 在MacOS上：~/Library/Application\ Support/Claude/claude_desktop_config.json
• 在Windows上：%APPDATA%/Claude/claude_desktop_config.json

"mcpServers": {
  "beeminder": {
    "command": "uv",
    "args": [
      "--directory",
      "/path/to/repo/mcp-beeminder",
      "run",
      "mcp-beeminder"
    ],
    "env": {
        "BEEMINDER_API_KEY": "YOUR_BEEMINDER_API_KEY",
        "BEEMINDER_USERNAME": "YOUR_BEEMINDER_USERNAME"
    }
  }
}

3. 安装并打开Claude桌面应用。
4. 尝试让Claude执行某种读写操作以确认设置是否正确（例如列出你的Beeminder目标）。如果存在问题，请使用MCP文档中提供的调试工具这里。

致谢

感谢@ianm199的beeminder-client包，本项目基于此包。

当然还要感谢Beeminder团队构建了如此出色的产品！