FreeStyle Libre (LibreLinkUp)

freestyle-libre-mcp

Claude（または任意のMCPクライアント）に、LibreLinkUp経由で共有されたFreeStyle Libre CGMの血糖値を読み取り専用で提供するMCPサーバーです。独自の小さな非同期クライアント（librelinkup_mcp.core）で LibreLinkUp APIと通信します。利用しているAPIの動作は pylibrelinkupに準拠しています。

ツール

ツール	戻り値
list_patients	LibreLinkUpアカウントがフォローしている人
get_current_glucose	トレンド矢印付きの最新の測定値
get_glucose_graph	過去約12時間の測定値（古い順）
get_glucose_logbook	過去約2週間の記録されたイベント（古い順）

すべての測定ツールでは、任意のpatientを指定できます。名前（"Ann Lee"、"ann"）または list_patientsのpatient_idを指定してください。アカウントが1人だけをフォローしている場合は省略できます。

測定値には、アカウントの単位でのvalue、value_mg_dl、unit、timestamp（センサーの現地時刻）、 timestamp_utc、およびis_high／is_lowフラグが含まれます。現在の測定値にはage_minutesも含まれます。 センサーまたはスマートフォンが通信範囲外の場合、LibreLinkUpは最後に確認された値を返すためです。

セットアップ

アカウントの設定やトラブルシューティングを含む手順ごとのガイドについては、 インストールガイドをご覧ください。 ドキュメント全文はhttps://freestyle-libre-mcp.readthedocs.ioにあります。

LibreLinkUpのフォロワーアカウントが必要です。LibreLinkアプリから招待し、LibreLinkUpアプリで招待を承認して、 このサーバーを使用する前に、同アプリで必要な利用規約にも同意してください。

git clone https://github.com/osjayaprakash/freestyle-libre-mcp.git && cd freestyle-libre-mcp
uv sync

変数	必須	デフォルト	説明
LIBRELINKUP_EMAIL	はい		フォロワーアカウントのメールアドレス
LIBRELINKUP_PASSWORD	はい		フォロワーアカウントのパスワード
LIBRELINKUP_REGION	いいえ	US	US、EU、EU2、AE、AP、AU、CA、DE、FR、JP、LA、RUのいずれか

リージョンが誤っている場合は、最初のツール呼び出しで設定すべきリージョンが通知されます。

PyPIから実行

リポジトリをクローンする必要はありません。uvが公開済みパッケージを取得して実行します。

uvx freestyle-libre-mcp

クライアント設定では、"command": "uvx", "args": ["freestyle-libre-mcp"]を使用してください。

Dockerで実行

このサーバーはstdio経由でMCPと通信するため、-iを付けてください。

docker run -i --rm \
  -e LIBRELINKUP_EMAIL -e LIBRELINKUP_PASSWORD -e LIBRELINKUP_REGION \
  ghcr.io/osjayaprakash/freestyle-libre-mcp:latest

クライアント設定では、これらの引数とともに"command": "docker"を使用し、クライアントのenvブロックを通じて 環境変数を渡してください。

Claude Desktop

claude_desktop_config.jsonに追加します。

{
  "mcpServers": {
    "librelinkup": {
      "command": "uv",
      "args": ["--directory", "/absolute/path/to/freestyle-libre-mcp", "run", "freestyle-libre-mcp"],
      "env": {
        "LIBRELINKUP_EMAIL": "[email protected]",
        "LIBRELINKUP_PASSWORD": "your-password",
        "LIBRELINKUP_REGION": "US"
      }
    }
  }
}

Claude Code

claude mcp add librelinkup \
  -e [email protected] \
  -e LIBRELINKUP_PASSWORD=your-password \
  -e LIBRELINKUP_REGION=US \
  -- uv --directory /absolute/path/to/freestyle-libre-mcp run freestyle-libre-mcp

Langfuse トレーシング（任意）

各ツール呼び出しが Langfuse のトレースになり、LibreLinkUp API 呼び出しの子スパンが作成されます。 追加パッケージをインストールし、キーを設定します。

uv sync --extra langfuse

サーバーコマンドでは、run freestyle-libre-mcp の代わりに run --extra langfuse freestyle-libre-mcp を使用します。

変数	意味
LANGFUSE_PUBLIC_KEY、LANGFUSE_SECRET_KEY	両方が設定されている場合のみトレーシングが有効になります
LANGFUSE_BASE_URL	セルフホストまたはリージョン別インスタンス用の Langfuse URL（デフォルト：Langfuse Cloud）
LANGFUSE_CAPTURE_DATA	ツールの入力、出力、エラーメッセージを含める場合は true に設定します。デフォルトは false です

プライバシー： 血糖値の測定値と患者名は健康データです。デフォルトでは、トレースに含まれるのはツール名、処理時間、患者 UUID、エラークラス名のみです。 LANGFUSE_CAPTURE_DATA=true に設定すると、測定値と名前が Langfuse インスタンスに送信されます。セルフホスト型など、信頼できるインスタンスでのみ設定してください。

開発

uv sync
uv run pytest            # offline suite
uv run pytest -m live    # hits the real API; needs LIBRELINKUP_EMAIL/PASSWORD
uv run ruff check src tests && uv run ruff format --check src tests

ライセンス

MIT