🚀 我们的 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 文件。