MCP 服务器

MCP Beeminder Server

一个 MCP 服务器，为 AI 助手提供访问 Beeminder API 的权限，使它们能够通过自然语言帮助用户跟踪目标、管理数据点以及与 Beeminder 的自我承诺工具进行交互。

README

MCP Beeminder 服务器

本项目实现了一个模型上下文协议 (MCP) 服务器，用于与 Beeminder API 交互。

Beeminder MCP 服务器

什么是 MCP？

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

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

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

什么是 Beeminder？

Beeminder 是一种通过以下方式克服意志力薄弱（做出违背更好判断的行为）的工具：

量化自我追踪
通过“鲜红线 (BRL)”进行视觉反馈，显示您的承诺路径
随着每次失败而增加的经济风险
具有 7 天“意志力薄弱期限”的灵活承诺

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

功能

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

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

使用 Claude Desktop 应用程序在本地运行

前提条件

您需要您的 Beeminder API 密钥和用户名才能运行服务器。要获取您的 API 密钥：

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

您还需要安装 uv。有关安装说明，请参阅 uv 文档。您可以使用其他工具，但您需要更改 claude_desktop_config.json 文件中的 command。

手动安装

克隆此存储库。
将以下内容添加到您的 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"
    }
  }
}