JinDaGe - oura-mcp-server MCP Details

article

README

🚀 我们的 MCP 服务器

这是一个基于 Model Context Protocol (MCP) 的服务器，它提供了对 Oura API 的访问能力，能够让语言模型轻松查询睡眠、准备度和恢复力数据。

✨ 主要特性

提供多种数据查询工具，支持按日期范围和今日数据进行查询。
为常见问题提供易于理解的错误信息，方便调试和使用。

🚀 快速开始

您需要一个 Oura API 令牌才能使用此服务器。可以通过以下步骤获取：

前往 Oura 开发者控制台
创建一个个人访问令牌

💻 使用示例

基础用法

更新您的 claude_desktop_config.json（位于 ~/Library/Application\ Support/Claude/claude_desktop_config.json macOS 上和 %APPDATA%/Claude/claude_desktop_config.json Windows 上）以包含以下内容：

{
    "mcpServers": {
        "oura": {
            "command": "uvx",
            "args": [
                "oura-mcp-server"
            ],
            "env": {
                "OURA_API_TOKEN": "YOUR_OURA_API_TOKEN"
            }
        }
    }
}

高级用法

一旦连接，您可以询问 Claude 如下问题：

“今天我的睡眠分数是多少？”
“显示我过去一周的准备度数据”
“1月1日至1月7日我的睡眠情况如何？”
“今天的恢复力评分是多少？”

🔧 技术细节

可用工具

该服务器公开了以下工具：

日期范围查询

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()：获取今天的恢复力数据

错误处理

该服务器为常见问题提供易于理解的错误信息：

无效日期格式
API 认证错误
网络连接问题

📄 许可证

该项目在 MIT 许可证下发布，详细信息请参阅 LICENSE 文件。

oura-mcp-server