Fitbit MCP

🚀 Fitbit MCP (Model Context Protocol)

這是一個適用於Fitbit的模型上下文協議（MCP）實現，可讓AI助手訪問並分析你的Fitbit健康和健身數據。需要注意的是，這是一個使用Fitbit公共API構建的非官方集成，與Fitbit公司沒有關聯，也未得到其認可。

免責聲明：本項目是使用Fitbit的公共API構建的非官方集成，與Fitbit公司沒有關聯，也未得到其認可。

🚀 快速開始

🔧 使用方法

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開發者門戶創建一個應用程序。
2. 將OAuth 2.0應用程序類型設置為“個人”。
3. 將回調URL設置為“http://localhost:3000”。
4. 創建應用程序後，記錄下你的客戶端ID和客戶端密鑰。
5. 使用OAuth 2.0授權流程獲取訪問令牌。

有關OAuth身份驗證的詳細說明，請參閱Fitbit API文檔。

🤝 貢獻代碼

歡迎貢獻代碼！你可以按照以下步驟進行貢獻：

1. 分叉倉庫。
2. 創建你的功能分支 (git checkout -b feature/amazing-feature)。
3. 提交你的更改 (git commit -m 'Add some amazing feature')。
4. 將更改推送到分支 (git push origin feature/amazing-feature)。
5. 打開一個拉取請求。

每個拉取請求都會觸發一個GitHub Actions工作流，用於驗證構建過程。

💻 開發設置

# 克隆倉庫
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. 創建一個新的GitHub版本，並使用如v1.0.1這樣的標籤。
3. GitHub Actions工作流將自動構建並將包發佈到NPM。

請確保在你的GitHub倉庫設置中配置了NPM_TOKEN密鑰。

📄 許可證

本項目採用MIT許可證 - 有關詳細信息，請參閱LICENSE文件。