Polar MCP服务器
用于Polar AccessLink API的MCP（模型上下文协议）服务器。将您的Polar健身数据连接到Claude AI-访问锻炼、睡眠分析、恢复指标、心率数据等。
快速启动（公共实例）
无需设置！ 使用我们的托管实例：
- 在克劳德： 设置→ 集成→ 添加MCP服务器
- 输入URL：
https://polar-mcp-server.n-neuhaeusel.workers.dev/mcp - Claude将打开一个授权窗口——使用您的Polar帐户登录
- 开始聊你的健身数据吧！
特性
25种可用工具
| 类别 | 工具 | 描述 |
|---|---|---|
| 练习 | get_exercises, get_exercise | 人力资源、速度、区域的培训数据 |
| 练习导出 | get_exercise_fit, get_exercise_tcx, get_exercise_gpx | 以FIT、TCX、GPX格式导出 |
| 睡眠 | get_sleep, get_sleep_range | 睡眠阶段、得分、持续时间 |
| 恢复 | get_nightly_recharge, get_nightly_recharge_range | ANS电荷、HRV、呼吸频率 |
| 活动 | get_daily_activity, get_daily_activity_range, get_activity_samples, get_activity_samples_range | 步数、卡路里、活动区 |
| 心率 | get_continuous_heart_rate, get_continuous_heart_rate_range | 24/7心率监测 |
| 训练负荷 | get_cardio_load, get_cardio_load_range, get_cardio_load_history | TRIMP，急性/慢性负荷 |
| SleepWise | get_sleepwise_alertness, get_sleepwise_circadian_bedtime | 警觉性预测，最佳就寝时间 |
| 生物传感。 | get_body_temperature, get_skin_temperature, get_spo2 | 温度、SpO2数据 |
| 用户 | get_user_info, get_physical_info | 个人资料、最大摄氧量、静息心率 |
支持的设备
- Polar Pacer/Pacer Pro
- Polar Vantage V2/V3
- Polar Vantage M/M2
- Polar Grit X/Grit X Pro/Grit X2 Pro
- 极性点燃物/点燃物2/点燃物3
- 极地联合
- 还有更多。..
示例提示
连接后，问克劳德：
- “显示我上周的锻炼”
- “我昨晚睡得怎么样？把它和我的周平均值比较一下”
- “分析我的心率变异性趋势”
- “我目前的训练负荷状况如何？”
- “我今晚什么时候睡觉才能恢复到最佳状态？”
- “将上次运行导出为GPX文件”
- “这个月我走了多少步？”
自我寄宿
想运行自己的实例吗？有两种部署选项可供选择：
选项1:Cloudflare Workers（推荐）
先决条件
设置
# Clone and install
git clone https://github.com/NelsonNew/polar-mcp-server.git
cd polar-mcp-server
npm install
# Create KV namespace
npx wrangler kv namespace create OAUTH_KV
# Copy the ID to wrangler.toml
# Set secrets
npx wrangler secret put POLAR_CLIENT_ID
npx wrangler secret put POLAR_CLIENT_SECRET
# Deploy
npm run deploy部署后，将回调URL添加到您的Polar应用程序中：
https://YOUR-WORKER.workers.dev/callback选项2：本地（克劳德桌面）
# Clone and build
git clone https://github.com/NelsonNew/polar-mcp-server.git
cd polar-mcp-server
npm install && npm run build
# Get access token
export POLAR_CLIENT_ID="your_client_id"
export POLAR_CLIENT_SECRET="your_client_secret"
npm run auth添加到Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"polar": {
"command": "node",
"args": ["/path/to/polar-mcp-server/dist/index.js"],
"env": {
"POLAR_ACCESS_TOKEN": "your_access_token"
}
}
}
}API 参考
所有工具都使用 Polar AccessLink API v3.
| 工具 | 端点 | 描述 | ||
|---|---|---|---|---|
get_user_info | /users/{id} | 用户资料 | ||
get_physical_info | /users/physical-information | 最大摄氧量、最大心率、静息心率 | ||
get_exercises | /exercises | 最后30天的锻炼 | ||
get_exercise | /exercises/{id} | 单次训练细节 | ||
get_exercise_fit/tcx/gpx | `/exercises/{id}/fit\ | tcx\ | gpx` | 导出格式 |
get_sleep | /users/sleep | 睡眠数据 | ||
get_nightly_recharge | /users/nightly-recharge | 恢复指标 | ||
get_daily_activity | /users/activities | 日常活动 | ||
get_continuous_heart_rate | /users/continuous-heart-rate | 24/7小时 | ||
get_cardio_load | /users/cardio-load | 训练负荷 | ||
get_sleepwise_alertness | /users/sleepwise/alertness | 警觉性预测 | ||
get_body_temperature | /users/biosensing/bodytemperature | 体温 | ||
get_spo2 | /users/biosensing/spo2 | 血氧 |
故障排除
| 错误 | 解决方案 |
|---|---|
| “Polar API错误（403）” | 重新授权或检查数据同步是否完成 |
| “Polar API错误（404）” | 端点不可用于您的设备/订阅 |
| 无运动数据 | 请先将您的Polar设备同步到Polar Flow应用程序 |
隐私
- 您的Polar凭据永远不会被存储
- OAuth令牌由Cloudflare Workers OAuth提供商安全管理
- 每个用户都有自己的隔离MCP会话
- 我们的服务器上没有记录或存储健身数据
贡献
欢迎投稿！请打开问题或PR。
许可证
麻省理工学院