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文件。