MCP Beeminder

🚀 MCP Beeminder 服务器

本项目实现了一个 模型上下文协议 (MCP) 服务器，用于与 Beeminder API 进行交互。通过该服务器，能让 AI 助手更好地助力用户管理 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\ 支持/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 文档中提供的调试工具 此处。

✨ 主要特性

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

• 目标管理（创建、读取、更新、删除）
• 数据点管理（创建、读取、删除）
• 用户信息检索
• 支持所有 Beeminder 目标类型：
  • 更多行动 ("hustler")
  • 计算器 ("biker")
  • 减重 ("fatloser")
  • 增重 ("gainer")
  • 更少收件箱 ("inboxer")
  • 更少饮酒 ("drinker")

📚 详细文档

什么是MCP？

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

MCP 采用客户端 - 服务器架构：

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

什么是Beeminder？

Beeminder 是一个克服行动懒散 (akrasia) 的工具，通过结合：

• 自我量化跟踪
• 反馈机制的 "亮红线" (BRL)，显示承诺路径
• 失败时增加的财务风险
• 灵活的承诺，带有 7 天的 "akrasia 周期"

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

📄 许可证

文档中未提及相关许可证信息。

🙏 致谢

感谢 @ianm199 的beeminder - client 包，该项目基于此开发。当然也要感谢 Beeminder 团队构建了如此出色的产品！