MCP Beeminder

🚀 MCP Beeminder サーバ

このプロジェクトは、Beeminder API とのやり取りを行う モデルコンテキストプロトコル (MCP) サーバを実装しています。

🚀 クイックスタート

このサーバは、Beeminder API の MCP 互換アクセスを提供し、AI アシスタントがユーザーの Beeminder 目標、データポイント、および関連機能を管理するのを支援できるようにします。

✨ 主な機能

このサーバは、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 周期」を持つ柔軟な約束

📦 インストール

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 ドキュメントに記載されているデバッグツール ここ を使用してください。

📄 ライセンス

このプロジェクトは、@ianm199 の beeminder-client パッケージに基づいて開発されています。当然ながら、素晴らしい製品を構築してくれた Beeminder チームにも感謝します！