AI导哈

Polar MCP 服务器

Polar MCP服务器是连接Polar健身数据与Claude AI的模型上下文协议服务器，提供锻炼、睡眠分析、恢复指标、心率数据等多种健身数据访问功能。

  • by NelsonNew
  • TypeScript
  • 本地部署
  • 6 星标
  • 更新于
在 GitHub 查看 NelsonNew/polar-mcp-server

使用说明

Polar MCP服务器

用于Polar AccessLink API的MCP（模型上下文协议）服务器。将您的Polar健身数据连接到Claude AI-访问锻炼、睡眠分析、恢复指标、心率数据等。

快速启动（公共实例）

无需设置！ 使用我们的托管实例：

  1. 在克劳德： 设置→ 集成→ 添加MCP服务器
  2. 输入URL： https://polar-mcp-server.n-neuhaeusel.workers.dev/mcp
  3. Claude将打开一个授权窗口——使用您的Polar帐户登录
  4. 开始聊你的健身数据吧！

特性

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。

许可证

麻省理工学院

链接

相关 MCP