Fitbit

🚀 Fitbit モデルコンテキストプロトコル (MCP) サーバ

このプロジェクトは、モデルコンテキストプロトコル（MCP）に準拠したサーバを実装しており、大規模言語モデル（例えば Claude）と Fitbit API の間の橋渡し役を果たします。

このサーバを通じて、LLM はユーザーの Fitbit アカウントから健康およびフィットネスデータを要求し、取得することができます。定義されたツールを介してやり取りが行われます。

✨ 主な機能

• Fitbit API 統合： OAuth 2.0 を使用して Fitbit API に安全に接続します。
• MCP 互換性： モデルコンテキストプロトコルに準拠したツールを通じて Fitbit データを提供します。
• 拡張性： さらに多くの Fitbit API エンドポイントを簡単にサポートできるように設計されています。

サポートされているエンドポイント

• 体重：
  • get_weight：指定された期間（1d、7d、30d、3m、6m、1y）内の生の体重データを、今日を終了日として取得します。period パラメータが必要です。
• 睡眠：
  • get_sleep_by_date_range：指定された日付範囲（最大 100 日）内の生の睡眠ログデータを取得します。startDate と endDate の 2 つのパラメータが必要で、どちらも YYYY-MM-DD 形式です。
• プロフィール：
  • get_profile：ユーザーの Fitbit プロフィール情報を取得します。

予定されているエンドポイント

将来的には、以下を含むさらに多くの Fitbit API エンドポイントのサポートが予定されています。

• 活動データ
• 心拍数監視
• 血圧記録
• 身長など

📦 インストール

1. リポジトリをクローンする：

   git clone [リポジトリのURL]
   cd fitbit-mcp-server
   

2. 依存関係をインストールする：

   npm install
   

3. 環境変数を設定する：

   • .env ファイルを作成し、以下の内容を追加します。

     FITBIT_CLIENT_ID=your_client_id
     FITBIT_CLIENT_SECRET=your_client_secret
     

4. プロジェクトをビルドする：

   npm run build
   

5. サーバを起動する：

   npm start
   

🚀 クイックスタート

このサーバを Claude 環境に統合するには、以下の手順に従ってください。

1. ビルドされた dist フォルダ内のファイルを Claude のツールパスに追加します。
2. Claude の設定ファイル（通常は config.json）に以下の内容を追加します。

   {
     "tools": [
       {
         "name": "get_weight",
         "description": "指定された期間内の体重データを取得します。",
         "parameters": {
           "type": "object",
           "properties": {
             "period": {
               "type": "string",
               "enum": ["1d", "7d", "30d", "3m", "6m", "1y"],
               "description": "指定する期間。'1d'、'7d'、'30d'、'3m'、'6m'、'1y' のいずれかです。"
             }
           }
         }
       },
       {
         "name": "get_sleep_by_date_range",
         "description": "指定された日付範囲内の睡眠データを取得します。",
         "parameters": {
           "type": "object",
           "properties": {
             "startDate": {
               "type": "string",
               "format": "date",
               "description": "開始日付。'YYYY-MM-DD' 形式です。"
             },
             "endDate": {
               "type": "string",
               "format": "date",
               "description": "終了日付。'YYYY-MM-DD' 形式です。"
             }
           }
         }
       },
       {
         "name": "get_profile",
         "description": "ユーザーの Fitbit プロフィール情報を取得します。",
         "parameters": {}
       }
     ]
   }
   

💻 使用例

基本的な使用法

以下は、サーバが起動した後に利用可能なツールの概要です。

• get_weight：指定された期間内の体重データを返します。
  • パラメータ： period（文字列、必須） - 指定する期間。"1d"、"7d"、"30d"、"3m"、"6m"、"1y" のいずれかです。
  • 使用例（概念的）： get_weight(period="7d")
• get_sleep_by_date_range：指定された日付範囲内の睡眠データを返します。
  • パラメータ：
    • startDate（文字列、必須） - 開始日付を YYYY-MM-DD 形式で指定します。
    • endDate（文字列、必須） - 終了日付を YYYY-MM-DD 形式で指定します。
  • 使用例（概念的）： get_sleep_by_date_range(startDate="2025-04-01", endDate="2025-04-30")
• get_profile：ユーザーの Fitbit プロフィール情報を返します。
  • パラメータ： なし
  • 使用例（概念的）： get_profile()

🔧 技術詳細

• ソースコードは src/ ディレクトリにあります。
• TypeScript ファイルを変更した後は、npm run build を実行してビルドしてください。
• サーバが既に Claude 環境で実行されている場合は、Claude を再起動して最新のビルドを認識させてください。