Oura MCP服务
通过模型上下文协议（MCP）启用从 Oura API 查询睡眠、就绪性和恢复力数据的功能，允许自然语言交互，并与 Claude 等工具无缝集成。
MCP 服务配置
复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用
{
"mcpServers": {
"oura": {
"args": [
"oura-mcp-server"
],
"command": "uvx",
"env": {
"OURA_API_TOKEN": "YOUR_OURA_API_TOKEN"
}
}
}
}该服务需要配置环境变量：OURA_API_TOKEN
可用工具 （6 个）
该服务在 MCP 协议中暴露的工具，AI 可按需调用
get_sleep_data 2 个参数 需填 2 项
Get sleep data for a specific date range. Args: start_date: Start date in ISO format (YYYY-MM-DD) end_date: End date in ISO format (YYYY-MM-DD) Returns: Dictionary containing sleep data
必填参数：start_date、end_date
get_readiness_data 2 个参数 需填 2 项
Get readiness data for a specific date range. Args: start_date: Start date in ISO format (YYYY-MM-DD) end_date: End date in ISO format (YYYY-MM-DD) Returns: Dictionary containing readiness data
必填参数：start_date、end_date
get_resilience_data 2 个参数 需填 2 项
Get resilience data for a specific date range. Args: start_date: Start date in ISO format (YYYY-MM-DD) end_date: End date in ISO format (YYYY-MM-DD) Returns: Dictionary containing resilience data
必填参数：start_date、end_date
get_today_sleep_data
Get sleep data for today. Returns: Dictionary containing sleep data for today
该工具无需必填参数，直接调用即可
get_today_readiness_data
Get readiness data for today. Returns: Dictionary containing readiness data for today
该工具无需必填参数，直接调用即可
get_today_resilience_data
Get resilience data for today. Returns: Dictionary containing resilience data for today
该工具无需必填参数，直接调用即可
服务介绍
Oura MCP 服务器
这是一个 模型上下文协议 (MCP) 服务器，提供了对 Oura API 的访问。它允许语言模型从 Oura API 查询睡眠、准备度和恢复力数据。
可用工具
该服务器公开了以下工具：
日期范围查询
get_sleep_data(start_date: str, end_date: str): 获取特定日期范围内的睡眠数据get_readiness_data(start_date: str, end_date: str): 获取特定日期范围内的准备度数据get_resilience_data(start_date: str, end_date: str): 获取特定日期范围内的恢复力数据
日期应以 ISO 格式 (YYYY-MM-DD) 提供。
当日数据查询
get_today_sleep_data(): 获取当日的睡眠数据get_today_readiness_data(): 获取当日的准备度数据get_today_resilience_data(): 获取当日的恢复力数据
使用方法
使用此服务器需要一个 Oura API 令牌。你可以通过以下步骤获取：
- 前往 Oura 开发者门户
- 创建一个个人访问令牌
Claude 桌面版
更新你的 claude_desktop_config.json（在 macOS 上位于 ~/Library/Application\ Support/Claude/claude_desktop_config.json，在 Windows 上位于 %APPDATA%/Claude/claude_desktop_config.json），包含以下内容：
{
"mcpServers": {
"oura": {
"command": "uvx",
"args": [
"oura-mcp-server"
],
"env": {
"OURA_API_TOKEN": "YOUR_OURA_API_TOKEN"
}
}
}
}
示例查询
连接后，你可以向 Claude 提出如下问题：
- "我今天的睡眠得分是多少？"
- "显示我过去一周的准备度数据"
- "我从 1 月 1 日到 1 月 7 日的睡眠情况如何？"
- "我今天的恢复力得分是多少？"
错误处理
对于常见问题，服务器提供可读性强的错误信息：
- 无效的日期格式
- API 认证错误
- 网络连接问题
许可证
本项目采用 MIT 许可证 - 详情请参见 LICENSE 文件。
