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 團隊構建瞭如此出色的產品！