Oura MCP Server

Oura MCP 服务

一个可访问 Oura API 的 Model Context Protocol（MCP）服务。它允许大模型从 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 令牌。你可以通过以下步骤获取：

1. 前往 Oura Developer Portal
2. 创建个人访问令牌

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 文件。