Fitbit MCP

🚀 Fitbit MCP (Model Context Protocol)

Fitbit用のModel Context Protocol (MCP) 実装で、AIアシスタントがFitbitの健康とフィットネスデータにアクセスし分析できるようにします。

🚀 クイックスタート

このFitbit MCPは、Fitbitの公開APIを使用して構築された非公式の統合であり、Fitbit Inc.とは関係がなく、承認もされていません。

💻 使用例

基本的な使用法

JSON設定（AIアシスタントフレームワークで使用する場合）:

{
  "command": "npx",
  "args": ["-y", "fitbit-mcp", "--stdio"],
  "env": {
    "FITBIT_ACCESS_TOKEN": "YOUR_FITBIT_ACCESS_TOKEN"
  }
}

または、環境変数の代わりに引数を使用する場合:

{
  "command": "npx",
  "args": ["-y", "fitbit-mcp", "--stdio", "--fitbit-token=YOUR_FITBIT_ACCESS_TOKEN"]
}

📚 ドキュメント

利用可能なツール

このMCPは、AIアシスタントがFitbitデータにアクセスするための以下のツールを提供します:

• getUserProfile: Fitbitのプロフィール情報を取得します。
• getActivities: 指定した日付の活動データを取得します。
• getSleepLogs: 指定した日付の睡眠データを取得します。
• getHeartRate: 指定した日付と期間の心拍数データを取得します。
• getSteps: 指定した日付と期間の歩数を取得します。
• getBodyMeasurements: 体重と体脂肪率のデータを取得します。
• getFoodLogs: 指定した日付の食事記録データを取得します。
• getWaterLogs: 指定した日付の水分摂取量データを取得します。
• getLifetimeStats: 生涯活動統計を取得します。
• getUserSettings: ユーザー設定と嗜好を取得します。
• getFloorsClimbed: 登った階数のデータを取得します。
• getDistance: 移動距離のデータを取得します。
• getCalories: 消費カロリーのデータを取得します。
• getActiveZoneMinutes: アクティブゾーンの分数データを取得します。
• getDevices: 接続されているFitbitデバイスの情報を取得します。
• getBadges: 獲得したバッジと実績を取得します。

ほとんどのツールは、オプションのパラメータを受け付けます:

• date: YYYY-MM-DD形式の日付（デフォルトは今日）
• period: データの期間（1d、7d、30d、1w、1m）

Fitbitアクセストークンの取得方法

Fitbitアクセストークンを取得するには:

1. Fitbit Developer Portalでアプリケーションを作成します。
2. OAuth 2.0アプリケーションタイプを「Personal」に設定します。
3. コールバックURLを「http://localhost:3000」に設定します。
4. アプリケーションを作成した後、クライアントIDとクライアントシークレットをメモします。
5. OAuth 2.0認証フローを使用してアクセストークンを取得します。

OAuth認証の詳細な手順については、Fitbit API Documentationを参照してください。

開発環境のセットアップ

# リポジトリをクローンする
git clone https://github.com/your-username/fitbit-mcp.git
cd fitbit-mcp

# 依存関係をインストールする
npm install

# プロジェクトをビルドする
npm run build

# 開発モードで実行する
npm run dev

リリースプロセス

新しいバージョンをNPMに公開するには:

1. package.jsonのバージョンを更新します。
2. v1.0.1のようなタグ付きで新しいGitHubリリースを作成します。
3. GitHub Actionsワークフローが自動的にパッケージをビルドしてNPMに公開します。

GitHubリポジトリの設定でNPM_TOKENシークレットが設定されていることを確認してください。

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細については、LICENSEファイルを参照してください。

⚠️ 重要提示

これはFitbitの公開APIを使用して構築された非公式の統合であり、Fitbit Inc.とは関係がなく、承認もされていません。