使用说明
SensorBio MCP服务器
A. 模型上下文协议 (MCP)服务器 感觉生物 可穿戴平台API(API.getsensr.io)。使AI助手能够从Sensr可穿戴设备访问实时生物特征、睡眠、活动和健康评分数据。
工具
| 工具 | 说明 |
|---|---|
list_users |
列出组织中的所有用户 |
get_user_ids |
获取所有用户ID(轻量级) |
get_biometrics |
分页生物特征读数(心率、心率变异性、血氧饱和度、呼吸频率) |
get_biometrics_timeseries |
一个指标的连续生物特征时间序列(最大6小时窗口) |
get_activity_timeseries |
标准化活动强度时间序列(最大6小时窗口) |
get_sleep |
睡眠数据:阶段、持续时间、生物特征、分数、干扰、债务 |
get_sleep_trend |
汇总睡眠数据(周/月/年) |
get_activities |
锻炼数据:锻炼、重复次数、卡路里、持续时间、分数 |
get_calories |
卡路里分解(休息、锻炼、活动)与时间序列 |
get_scores |
每日健康评分:睡眠、恢复、活动 |
get_insights |
人工智能生成的日常健康见解 |
get_devices |
设备信息:类型、电池、上次同步 |
get_health_summary |
每日快照(分数+睡眠+卡路里+设备) |
request_raw_download |
将原始数据(PPG、加速器、陀螺仪)异步导出为CSV/Parquet |
get_job_status |
检查原始数据下载作业状态 |
设置
先决条件
- Node.js>=18
- Sensr生物组织API密钥(来自 平台.getsensr.io >开发商)
安装
npm install
npm run build
配置
设置 SENSR_API_KEY 环境变量:
export SENSR_API_KEY="your-org-api-key-here"
跑
npm start
服务器使用MCP协议通过stdio进行通信。
与Claude Desktop一起使用
添加到您的 claude_desktop_config.json:
{
"mcpServers": {
"sensr-bio": {
"command": "node",
"args": ["/path/to/sensr-mcp-server/dist/index.js"],
"env": {
"SENSR_API_KEY": "your-org-api-key-here"
}
}
}
}
与Claude Code一起使用
claude mcp add sensr-bio -- node /path/to/sensr-mcp-server/dist/index.js
API覆盖范围
此服务器包装 Sensr开发人员API v1.3.1,包括:
- 生物识别:心率、心率变异性、血氧饱和度、呼吸频率、IBI
- 睡眠:阶段、分数、干扰、睡眠债务/会计
- 活动:运动检测、重复计数、运动分类
- 卡路里:休息、活动、锻炼分解
- 分数:睡眠、恢复、活动(每日综合)
- 设备:电池、同步状态、设备类型
- 组织:用户管理、用户列表
- 原始数据:异步PPG/加速器/陀螺仪输出
认证
使用组织API密钥身份验证(Authorization: APIKey <key>).生成一个 平台.getsensr.io >开发商。所有数据端点都需要 user_id 参数,指定要访问哪个用户的数据。
注: Sensr身份验证服务器不支持
authorization_code授予外部OAuth2应用程序。组织API密钥是第三方集成唯一支持的身份验证方法。
许可证
麻省理工学院
