MCP Beeminder Server

MCP蜂鸣器服务器

该项目实现了 模型上下文协议 （MCP） 用于交互的服务器 这 蜂鸣器 API

Beeminder MCP Server

什么是MCP？

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

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

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

什么是Beeminder？

Beeminder是一种克服akrasia（违背你更好的判断）的工具，它结合了：

• 量化自我跟踪
• 通过“亮红线”（BRL）显示您的承诺路径的视觉反馈
• 每次失败都会增加财务风险
• 灵活的承诺，7天的“自主视野”

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

特性

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

• 目标管理（创建、读取、更新、删除）
• 数据点管理（创建、读取、删除）
• 用户信息检索
• 支持所有Beeminder目标类型：

- 做更多（“骗子”） - 里程表（“摩托车手”） - 减肥（“肥胖者”） - 增重（“增重者”） - 收件箱更少（“收件箱”） - 少做（“饮酒者”）

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

先决条件

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

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

你还需要 uv 安装。请参阅 紫外线 文档 用于安装 说明。您可以使用其他东西，但需要更改 command 在 claude_desktop_config.json 文件。

手动安装

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文档中提供的调试工具 这里.

致谢

多亏了 @伊恩199 为他的 beeminder-client 包裹， 该项目正是基于此。

显然，这要归功于 蜂鸣器 团队为 打造如此出色的产品！