Oura MCP服务器（增强型）
MCP（模型上下文协议）服务器，提供对 Oura Ring API v2.展示17种工具，涵盖睡眠、活动、心率、压力、SpO2、锻炼等。
工具
睡眠与恢复
| 工具 | 说明 |
|---|---|
get_sleep_data | 详细的睡眠时段——阶段、心率、心率变异性、呼吸频率 |
get_daily_sleep | 每日睡眠评分和贡献者细分 |
get_sleep_time | 推荐和实际的睡眠时间窗口 |
get_daily_readiness | 准备度得分和贡献者（HRV平衡、体温等） |
get_daily_resilience | 恢复能力和应力耐受指标 |
活动与健身
| 工具 | 说明 |
|---|---|
get_daily_activity | 步数、卡路里、活动时间分解、MET水平 |
get_workouts | 锻炼时间，包括类型、卡路里、距离、持续时间 |
get_sessions | 生物识别引导课程（冥想、呼吸） |
get_vo2_max | VO2最大心血管健康估计值 |
健康体征
| 工具 | 说明 |
|---|---|
get_heart_rate | 每隔5分钟的心率（使用日期时间参数） |
get_daily_spo2 | 每日血氧饱和度 |
get_daily_stress | 每日压力水平和恢复总结 |
get_daily_cardiovascular_age | 估计心血管年龄 |
用户和设备
| 工具 | 说明 |
|---|---|
get_personal_info | 用户资料（年龄、体重、身高） |
get_ring_configuration | 戒指型号、颜色、固件、设置日期 |
get_rest_mode | 休息模式时段和时间表 |
get_tags | 用户创建的生活方式标签和注释 |
所有带有日期参数的工具都接受可选 start_date 和 end_date 在 YYYY-MM-DD 格式。当省略时，Oura API默认为最近的数据。
设置
选项A:Claude桌面扩展（推荐）
- 下载最新版
oura-mcp-server-enhanced.mcpb从 发布 - 在Claude Desktop中，转到 设置>扩展>高级设置 并启用 从文件安装
- 返回“扩展”页面，单击 从文件添加 并选择已下载的
.mcpb文件 - 输入您的 Oura API代币 当系统提示时
选项B：手动设置
1.获取Oura API代币
首选 Oura个人访问令牌 并创建新令牌。
2.安装
需要Python 3.12+和 紫外线.
git clone https://github.com/josuhr/oura-mcp-server-enhanced.git
cd oura-mcp-server-enhanced
uv venv && uv pip install -e .3.配置克劳德桌面
将以下内容添加到您的 claude_desktop_config.json:
{
"mcpServers": {
"oura": {
"command": "uv",
"args": ["run", "--directory", "/path/to/oura-mcp-server-enhanced", "oura-mcp-server"],
"env": {
"OURA_API_TOKEN": "your_token_here"
}
}
}
}替换 /path/to/oura-mcp-server-enhanced 与实际路径和 your_token_here 使用您的Oura API代币。
4.独立运行（可选）
export OURA_API_TOKEN="your_token_here"
oura-mcp-server构建扩展
为了构建 .mcpb 源代码中的扩展包：
zip -r oura-mcp-server-enhanced.mcpb manifest.json pyproject.toml uv.lock src/ .python-version -x "src/**/__pycache__/*"项目结构
src/oura_mcp_server/
├── __init__.py # Package entry point
├── server.py # FastMCP tool definitions and main()
├── client.py # Async HTTP client for Oura API v2
└── transforms.py # Human-readable data formatting学分
受...启发 tomekkorbak/oura mcp服务器，扩展到涵盖整个Oura API v2。