Beeminder目标管理服务器

一个基于MCP协议的Beeminder API服务器,允许AI助手帮助用户管理Beeminder目标、数据点等功能。

  • by strickvl
  • Python
  • 本地部署
  • 10 星标
  • 更新于
在 GitHub 查看 strickvl/mcp-beeminder

使用说明

MCP蜂鸣器服务器

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

什么是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 包裹, 该项目正是基于此。

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