oura-mcp-server 是一个 Model Context Protocol(MCP)服务器,提供对 Oura API 的访问。它允许语言模型查询 Oura API 中的睡眠、准备度(readiness)和韧性(resilience)数据。
主要能力: 服务器暴露以下工具:
日期范围查询:
- 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 token。获取方式:前往 Oura Developer Portal,创建 Personal Access Token。
在 Claude for Desktop 中配置: 更新 claude_desktop_config.json(macOS 位于 ~/Library/Application Support/Claude/claude_desktop_config.json,Windows 位于 %APPDATA%/Claude/claude_desktop_config.json),加入相应配置。
示例查询: 连接后,可以向 Claude 提问,例如:
- “What's my sleep score for today?”
- “Show me my readiness data for the past week”
- “How was my sleep from January 1st to January 7th?”
- “What's my resilience score today?”
错误处理: 服务器针对常见问题提供人类可读的错误消息,包括:无效日期格式、API 认证错误、网络连接问题。
许可: 本项目采用 MIT License,详见 LICENSE 文件。