Oura MCP Server

Oura MCP Server

site icon
2025.02.28 9
Python健康数据分析睡眠监测健康监测其它
Oura MCP Server 是一个基于 Model Context Protocol (MCP) 的服务,提供对 Oura API 的访问。它允许语言模型查询来自 Oura API 的睡眠、准备度和恢复力数据。
View on GitHub

Overview

基本能力

产品定位

Oura MCP Server 是一个中间件服务,旨在为语言模型提供访问 Oura API 的能力,主要用于健康数据分析领域。

核心功能

  • 提供对 Oura API 的访问
  • 支持查询睡眠数据、准备度数据和恢复力数据
  • 支持特定日期范围查询和当日数据查询

适用场景

  • 个人健康数据分析
  • 睡眠质量监测
  • 日常准备度和恢复力评估

工具列表

  1. Date Range Queries
  2. get_sleep_data(start_date: str, end_date: str): 获取特定日期范围内的睡眠数据
  3. get_readiness_data(start_date: str, end_date: str): 获取特定日期范围内的准备度数据
  4. get_resilience_data(start_date: str, end_date: str): 获取特定日期范围内的恢复力数据

  5. Today's Data Queries

  6. get_today_sleep_data(): 获取当天的睡眠数据
  7. get_today_readiness_data(): 获取当天的准备度数据
  8. get_today_resilience_data(): 获取当天的恢复力数据

常见问题解答

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

使用教程

使用依赖

  • Python 3.12
  • Oura API token

安装教程

  1. 获取 Oura API token:
  2. 访问 Oura Developer Portal
  3. 创建 Personal Access Token

  4. 配置 Claude for Desktop: 更新 claude_desktop_config.json 文件,添加以下内容: json { "mcpServers": { "oura": { "command": "uvx", "args": [ "oura-mcp-server" ], "env": { "OURA_API_TOKEN": "YOUR_OURA_API_TOKEN" } } } }

调试方式

  • 使用示例查询测试服务:
  • "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?"

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。