MCP Beeminder 服务器

该项目实现了与 Beeminder API 交互的 模型上下文协议 (MCP) 服务器。

什么是 MCP？

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

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

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

什么是 Beeminder？

Beeminder 是一个克服无自制力（违背自己更好的判断行事）的工具，它结合了以下几点：

• 量化自我追踪
• 通过“亮红线”（BRL）显示承诺路径的视觉反馈
• 每次失败都会增加的财务赌注
• 具有 7 天“无自制力地平线”的灵活承诺

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

功能

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

• 目标管理（创建、读取、更新、删除）
• 数据点管理（创建、读取、删除）
• 用户信息检索
• 支持所有 Beeminder 目标类型：
  • 做更多（"hustler"）
  • 表里程（"biker"）
  • 减肥（"fatloser"）
  • 增重（"gainer"）
  • 收件箱减少（"inboxer"）
  • 做更少（"drinker"）

使用 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"
    }
  }
}

1. 安装并打开Claude桌面应用程序。
2. 尝试让Claude执行某种读/写操作以确认设置（例如列出您的Beeminder目标）。如果有问题，请使用MCP文档中提供的调试工具这里。

致谢

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

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