Garmin MCP

🚀 佳明MCPサーバー

このモデルコンテキストプロトコル（MCP）サーバーは、Garmin Connectに接続し、あなたのフィットネスと健康に関するデータをClaudeやその他の互換性のあるクライアントに共有します。

✨ 主な機能

• 最近の活動を一覧表示する
• 詳細な活動情報を取得する
• 健康指標（歩数、心拍数、睡眠）にアクセスする
• 体組成データを表示する

📦 インストール

1. 新しい環境で必要なパッケージをインストールします。

virtualenv .venv
source .venv/bin/activate
python -m pip install -r requirements.txt

2. プロジェクトのルートディレクトリに.envファイルを作成し、Garminの認証情報を入力します。

GARMIN_EMAIL=your.email@example.com
GARMIN_PASSWORD=your-password

🚀 クイックスタート

Claude Desktopと一緒に使用する場合

1. Claude Desktopで設定を作成します。 Claude Desktopの設定ファイルを編集します。

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json このサーバーの設定を追加します。

{
  "mcpServers": {
    "garmin": {
      "command": "python", // 新しい環境を作成した場合は、これを "<ルートディレクトリ>/.venv/bin/python" にする必要があります
      "args": ["<パス>/garmin_mcp/garmin_mcp_server.py"]
    }
  }
}

パスをサーバーファイルの絶対パスに置き換えてください。 2. Claude Desktopを再起動します。

MCP Inspectorを使用してテストする場合

テストにはMCP Inspectorを使用できます。

npx @modelcontextprotocol/inspector python /Users/adomingues/Documents/claude_filesystem/garmin_mcp/garmin_mcp_server.py

💻 使用例

Claudeで正常に接続したら、以下の質問を行うことができます。

• "私の最近の活動を表示して"
• "昨夜の睡眠状況はどうでしたか？"
• "昨日は何歩歩きましたか？"
• "私の最新のランニングの詳細情報を表示して"

⚠️ 重要提示

このサーバーは.envファイルにGarmin Connectの認証情報が必要です。このファイルを安全に保管し、バージョン管理システムにコミットしないでください。

🔧 トラブルシューティング

ログイン問題が発生した場合：

1. .envファイルの認証情報が正しいことを確認します。
2. Garmin Connectが追加の認証を必要としていないか確認します。
3. garminconnectパッケージが最新バージョンであることを確認します。

その他の問題については、Claude Desktopのログを確認してください。

• macOS: ~/Library/Logs/Claude/mcp-server-garmin.log
• Windows: %APPDATA%\Claude\logs\mcp-server-garmin.log