Taxuspt/garmin_mcp

解決する課題

このプロジェクトは、Garmin ConnectとAIアシスタントの間のブリッジとして機能し、Claude DesktopのようなLLMインターフェースを通じて、フィットネスデータの照会、ワークアウトの管理、パフォーマンス指標の分析を直接行えるようにします。

仕組み

Model Context Protocol (MCP) を実装し、110以上のGarmin Connect APIエンドポイントをツールとして公開します。安全なCLIフローを通じて一度認証を行うと、サーバーがOAuthトークンをローカルに保存するため、設定ファイルに認証情報を保存することなく、LLMが健康データやアクティビティデータに安全にアクセスできます。データの読み取り（心拍数、睡眠、トレーニングステータスなど）と書き込み（アクティビティ詳細の編集やワークアウトのスケジュール設定など）の両方をサポートしています。

対象ユーザー

Garminフィットネスデバイスのユーザーで、AIを活用してトレーニングの深い洞察を得たり、複雑なワークアウトスケジュールを自動作成したり、自然言語を使用してアクティビティデータの高度な分析を行いたい方に最適です。

ハイライト

• 豊富なツール群: アクティビティ、健康指標、トレーニングステータス、ギア管理、栄養など、110以上のツールを提供します。
• 高度なワークアウトビルダー: JSONを手動で記述することなく、複雑なワークアウト（インターバルや筋力トレーニングを含む）を作成・スケジュールできます。
• 安全な認証: 専用のCLIツールを使用してOAuthトークンを処理するため、機密性の高い認証情報をMCP設定から分離できます。
• カスタマイズ可能なアクセス権: ツールフィルタリング（許可リスト/拒否リスト）をサポートしており、AIがアクセスできるデータや操作を制限できます。また、複数のGarminアカウントを同時にサポートします。