Oura MCP 服务器

这是一个提供访问Oura API的模型上下文协议 (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 开发者门户
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文件。 </中文翻译>