______________________________________________________________________
标题：README.md 说明：Ultrahuman MCP–Ultrahuman合作伙伴API的公共MCP服务器（bio-data，ring，CGM）。 创建时间：2026年3月15日 更新时间：2026年3月15日
超人类MCP
作者： 杜扎菲舍尔 &Mioré（AI）
A. 模型上下文协议（MCP） 服务器，允许LLM和代理通过 超人类合作伙伴API.
______________________________________________________________________
向超人呐喊
感谢超人团队 用于提供合作伙伴API，并使开发人员能够在其生物数据平台上进行构建。该MCP的存在是因为这种伙伴关系和 超人类视觉 开发者体验。如果您使用此工具，请考虑查看 超人类，他们的 以及他们的文档。
免责声明： 这是一个 私人社区项目 并且是 未正式隶属于或认可超人类。它以非官方身份使用公共合作伙伴API。我很乐意与Ultrahuman团队合作，以符合官方文档、品牌或最佳实践。
______________________________________________________________________
你能做什么
- 🩺 每日指标 –睡眠、心率、心率变异性、步数、恢复、血糖、代谢评分、最大摄氧量等（通过电子邮件+日期）。
- 🤖 从任何MCP客户端使用它：🦞 OpenClaw、Claude Code、Cursor、困惑计算机、Kimi Claw或您自己的代理。
- 🔐 仅在env变量中使用令牌和电子邮件，代码中没有秘密。
______________________________________________________________________
先决条件
- 🐍 Python 3.10+
- 🔑 超人类 合作伙伴API 访问：
- 授权令牌 （来自合作伙伴入职培训；作为 Authorization: 标头，没有“Bearer”前缀 UltraSignal API文档). - 用户电子邮件 –与您的合作伙伴共享数据的帐户（例如通过Ultrahuman应用程序中的合作伙伴ID）。
______________________________________________________________________
如何获取API令牌？ 🔑
合作伙伴API访问权限（以及您的 授权令牌)由超人类授予。一个简单的请求方式：
- 打开 超人类应用程序 并前往 得到帮助 （或应用内支持/帮助部分）。
- 描述你需要的 API访问 以及你想用它做什么。
- 一个很好的例子： *“我想将我的Ultrahuman Ring与我的人工智能代理/助手连接起来，这样我就可以从我的Ring数据中请求晨间简报、恢复检查和趋势。我正在构建\[例如，个人健康仪表板/MCP集成\]。我可以获得合作伙伴API访问权限和授权令牌吗？”*
在哪里可以找到帮助（截图）：
聊天支持（示例流程）：
收到令牌和（如适用）合作伙伴ID后，将其设置在 .env 如所述 设置 在......下面您的帐户电子邮件是您在应用程序中使用的电子邮件；您（或其他用户）可以通过以下方式将该帐户链接到您的合作伙伴 简介→ 设置→ 合作伙伴ID 在应用程序中。
______________________________________________________________________
设置
- 📁 克隆或复制此文件夹 （例如，进入您的工作区或专用工具目录）。
- 📦 安装依赖项 （建议：使用虚拟环境）：
cd ultrahuman-mcp
python3 -m venv .venv
source .venv/bin/activate # or .venv\Scripts\activate on Windows
pip install -r requirements.txt- ⚙️ 配置环境：
cp .env.example .env
# Edit .env and set:
# ULTRAHUMAN_TOKEN=your_authorization_token
# ULTRAHUMAN_EMAIL=user@example.com看 .env.示例 对于所有选项。 永不承诺 .env 或真正的代币。
- 🚀 运行MCP服务器 （stdio，适用于本地MCP客户端）：
python -m ultrahuman_mcp
# or
./scripts/run_mcp.sh在你的客户(🦞 OpenClaw、Claude Code、Cursor、困惑计算机、Kimi Claw等）：在MCP设置中使用相同的命令和项目目录添加此服务器，以便加载 .env.
______________________________________________________________________
环境变量
| 变量 | 必填 | 描述 |
|---|---|---|
ULTRAHUMAN_TOKEN | 是 | 合作伙伴API的授权令牌（以 Authorization 头球无“Bearer”前缀）。 |
ULTRAHUMAN_EMAIL | 是 | 获取数据的用户的电子邮件。 |
ULTRAHUMAN_BASE_URL | 否 | 基本URL（默认值： https://partner.ultrahuman.com). |
ULTRAHUMAN_API_PATH | 没有 | API路径（默认值： /api/v1/metrics 每 UltraSignal API文档). |
ULTRAHUMAN_LOG_JSON | 否 | 设置为 1 用于Watson风格的结构化日志记录（每个日志一行JSON timestamp, level, trace_id, duration_ms等等）。 |
______________________________________________________________________
MCP工具🛠️
| 工具 | 说明 |
|---|---|
ultrahuman_get_daily_metrics | 📋 获取给定电子邮件和日期的度量数据（睡眠、心率、心率变异性、步数、恢复、血糖等）。 |
ultrahuman_get_live_value | 📌 获取 一 日期的度量值（例如恢复、sleep_score、hrv）。为substrate返回紧凑的JSON：附加到代理的每条消息。 |
超人_每日_信息： 输入： email, date （年-月-日）。可选： response_format (json | markdown).
超人_get-live_value： 输入： metric （例如。 recovery, sleep_score, hrv, resting_hr, steps, recovery_index, movement_index, metabolic_score, vo2_max, heart_rate, temp).可选： date （默认值：昨天）， email （默认：来自env）。返回JSON： {"metric", "value", "date", "unit", "source": "ultrahuman"} （或 value: null 随着 message 如果该日期缺少度量）。基板可以将此对象与每条消息一起发送给代理。
______________________________________________________________________
技能
此回购包括 技能 该课程教授法学硕士如何在实际工作流程中使用MCP。将它们与MCP一起使用可获得最佳效果。
🧠 生物数据助理 技能/超人类生物数据助理/ --何时呼叫MCP，如何构建答案（睡眠、恢复、准备、趋势）。 → 晨间简报☀️ · 恢复检查💪 · 比较天数📅
📈 超人类分析 技能/超人类分析/ — 📊 周报·恢复趋势·睡眠一致性·代谢周·🔮 预测（明天准备就绪、训练负荷、低恢复警报）·🔗 相关性（睡眠-血糖、睡眠-恢复、工作日与周末）·📄 PDF/教练视图/每月一页·🏆 最佳夜晚·连胜·个人记录·每周MVP
| 技能 | 路径 | 目的 |
|---|---|---|
| 超人类生物数据助理 | 技能/超人类生物数据助理/ | 何时调用MCP，如何构建答案（睡眠、恢复、准备、趋势），以及如何解释指标。 |
| 超人类分析 | 技能/超人类分析/ | 周报、恢复趋势、睡眠一致性、代谢周、预测（明天准备、训练负荷、低恢复警报）、相关性（睡眠-血糖、睡眠-恢复、工作日与周末）、PDF/教练/月度报告、最佳夜晚、连胜、个人记录、每周MVP。 |
- 技能.md -触发器描述和工作流程（晨间简报、恢复检查、比较天数）。将此技能加载到您的AI助手中，以便它知道何时使用
ultrahuman_get_daily_metrics以及如何呈现结果。 - 参考文献 –可选： 度量值_损失.md （定义和单位）， 解释.md （“好”与“注意”范围的启发式）。
- 评估 – evals/evals.json 包含两种技能的测试提示（生物数据助理：晨间简报、恢复、3天比较；分析：周报、连胜、睡眠与血糖链接），用于技能创建者风格评估。
上述所有内容（周报、预测、相关性、教练视图、条纹等）都在 超人类分析 技能。
📄 将报告导出为PDF： 请助理提供“PDF摘要”或“导出过去7天”（启用分析技能）。它将返回可复制粘贴的Markdown（表格+摘要）。保存到a .md 文件，然后创建PDF，例如 潘多克。: pandoc summary.md -o report.pdf，或使用编辑器的“打印为PDF”/“导出为PDF”。
📊 一个带图表的PDF： 跑 python scripts/generate_ultrahuman_pdf_report.py （与 .env 设置）以获取 reports/ultrahuman_report_YYYY-MM-DD.pdf 睡眠与恢复、步数和心率变异性图表（过去7天）。需要 matplotlib 和 numpy 在 requirements.txt.
______________________________________________________________________
参考文献📚
______________________________________________________________________
许可证
该项目根据 MIT许可证 –参见 许可证 全文。简而言之：随意使用、分享和修改；保留版权声明。 注： Ultrahuman合作伙伴API的使用（通过本MCP或任何客户）受Ultrahuman的条款和合作伙伴协议的约束，该协议独立于本回购许可证。