Oura健康数据查询服务

一个基于Model Context Protocol (MCP)的服务,提供对Oura API的访问,允许语言模型查询睡眠、准备度和恢复力数据。

  • by tomekkorbak
  • Python
  • 本地部署
  • 39 星标
  • 更新于
在 GitHub 查看 tomekkorbak/oura-mcp-server

使用说明

Oura MCP服务器

A. 模型上下文协议 (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令牌才能使用此服务器。您可以通过以下方式获得:

  1. 前往the Oura开发者门户
  2. 创建个人访问令牌

Claude桌面版

更新您的 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日,我的睡眠怎么样?”
  • “我今天的韧性得分是多少?”

错误处理

服务器为常见问题提供人类可读的错误消息:

  • 日期格式无效
  • API身份验证错误
  • 网络连接问题

许可证

此项目根据MIT许可证获得许可-有关详细信息,请参阅许可证文件。