MCP Beeminder サーバー

このプロジェクトは、 Beeminder API と対話するためのモデルコンテキストプロトコル (MCP)サーバーを実装します。

MCPとは何ですか?

モデルコンテキストプロトコル（MCP）は、アプリケーションが大規模言語モデル（LLM）にコンテキストを提供する方法を標準化するオープンプロトコルです。これは「AIアプリケーション用のUSB-Cポート」のような役割を果たし、AIモデルをさまざまなデータソースやツールに接続するための標準化された方法を提供します。

MCP は次のようなクライアントサーバーアーキテクチャに従います。

MCP ホスト: Claude Desktop のようなプログラムや、MCP を介してデータにアクセスする IDE
MCPクライアント: サーバーとの1:1接続を維持するプロトコルクライアント
MCPサーバー: 標準化されたプロトコルを通じて特定の機能を公開する軽量プログラム
ローカルデータソース: MCP サーバーが安全にアクセスできるコンピューターのファイル、データベース、サービス
リモートサービス: MCP サーバーが接続できるインターネット経由で利用可能な外部システム

Beeminderとは何ですか?

Beeminder は、以下の要素を組み合わせることでアクラシア（自分の良識に反する行動）を克服するためのツールです。

定量化された自己追跡
あなたのコミットメントパスを示す「明るい赤い線」（BRL）による視覚的なフィードバック
失敗するたびに増大する金銭的リスク
7日間の「アクラシア・ホライズン」による柔軟なコミットメント

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

特徴

サーバーは、次のような Beeminder のコア機能へのアクセスを提供します。

目標管理（作成、読み取り、更新、削除）
データポイント管理（作成、読み取り、削除）
ユーザー情報の取得
すべての Beeminder 目標タイプをサポート:
- もっとやる（「ハスラー」）
- 走行距離計（バイカー）
- 減量（「ファットルーザー」）
- 体重を増やす（「ゲイナー」）
- 受信トレイを減らす（「インボクサー」）
- 飲酒量を減らす（「飲酒者」）

Claudeデスクトップアプリでローカルで実行する

前提条件

サーバーを実行するには、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"
    }
  }
}

Claude デスクトップアプリをインストールして開きます。
設定を確認するために、Claude に何らかの読み取り/書き込み操作を依頼してみてください（例：Beeminder の目標をリストアップする）。問題がある場合は、こちらのMCP ドキュメントで提供されているデバッグツールをご利用ください。

謝辞

このプロジェクトのベースとなっているbeeminder-clientパッケージを提供してくれた@ianm199に感謝します。

そしてもちろん、このような素晴らしい製品を開発してくれたBeeminderチームに感謝します。

MCP Beeminder Server