Ultrahuman MCP Server

超人类MCP服务器

   

模型上下文协议（MCP）服务器，提供对超人类API数据的访问。该服务器允许AI助手和应用程序通过标准化的MCP工具与超人类健康和健身数据进行交互。

特性

• 完整的健康指标访问：睡眠、运动、心率、心率变异性、血糖等
• 专用工具：针对不同数据类型（睡眠、运动、血糖、心脏指标）的专用工具
• 错误处理：具有详细错误消息的稳健错误处理
• 日期验证：日期格式的自动验证
• 环境配置：通过环境变量灵活配置

可用工具

核心工具

• get_default_user_metrics(date) -获取特定日期默认用户的所有健康指标（来自env）
• get_user_metrics(email, date) -获取特定日期用户的所有健康指标
• get_sleep_data(email, date) -获取特定睡眠指标
• get_movement_data(email, date) -获取运动和活动数据
• get_glucose_metrics(email, date) -获取葡萄糖相关指标
• get_heart_metrics(email, date) -获取心率、心率变异性和恢复数据

资源

• ultrahuman://api-info -关于超人类合作伙伴API的信息

可用指标

服务器提供对以下健康指标的访问：

1. 睡眠数据 -睡眠模式、质量、持续时间
2. 运动数据 -活动水平、运动模式
3. 心率 -连续心率监测
4. 心率变异性 -心率变异性测量
5. 温度 -体温读数
6. 步骤 -每日步数
7. 葡萄糖 -血糖水平（来自CGM）
8. 代谢评分 -总体代谢健康评分
9. 葡萄糖变异性（%） -血糖稳定性
10. 平均葡萄糖（mg/dL） -每日葡萄糖平均值
11. 糖化血红蛋白 -长期血糖控制指标
12. 目标时间（%） -在目标葡萄糖范围内花费的时间
13. 恢复指数 -恢复状态指标
14. 运动指数 -运动质量评估
15. 最大摄氧量 -心血管健康测量

设置

先决条件

1. 超人类API访问:

- 授权密钥（40个字符的字母数字字符串） - 来自用户的数据共享代码 - 已授予访问权限的用户电子邮件 - 📋 请参阅详细的设置说明: API_SETUP.md - 联系support@ultrahuman.com用于API访问 - API文件：https://blog.ultrahuman.com/blog/accessing-the-ultrahuman-partnership-api/

1. Python 3.11+

安装

1. 克隆此存储库：

git clone https://github.com/Vodolazkyi/Ultrahuman-Server.git
cd Ultrahuman-Server

1. 安装依赖项：

pip install -r requirements.txt

1. 配置环境变量：

cp env.example .env
# Edit .env with your Ultrahuman API credentials

1. 运行服务器：

python main.py

服务器将于启动 http://localhost:8000/mcp 默认情况下。

环境变量

使用示例

与MCP客户端一起使用

import asyncio
from mcp import ClientSession, StdioServerParameters
from mcp.client.stdio import stdio_client

async def main():
    server_params = StdioServerParameters(
        command="python",
        args=["main.py"],
        env={"ULTRAHUMAN_AUTH_KEY": "your_key_here"}
    )
    
    async with stdio_client(server_params) as (read, write):
        async with ClientSession(read, write) as session:
            # Initialize the connection
            await session.initialize()
            
            # Get user metrics
            result = await session.call_tool(
                "get_user_metrics",
                {
                    "email": "user@example.com",
                    "date": "2024-01-15"
                }
            )
            print(result)

if __name__ == "__main__":
    asyncio.run(main())

工具示例

获取完整指标

# Get all metrics for a user
result = await session.call_tool("get_user_metrics", {
    "email": "user@example.com",
    "date": "2024-01-15"
})

仅获取睡眠数据

# Get sleep-specific data
result = await session.call_tool("get_sleep_data", {
    "email": "user@example.com", 
    "date": "2024-01-15"
})

获取血糖指标

# Get glucose-related metrics
result = await session.call_tool("get_glucose_metrics", {
    "email": "user@example.com",
    "date": "2024-01-15"
})

API响应格式

所有工具都返回一致的响应格式：

{
    "success": true,
    "email": "user@example.com",
    "date": "2024-01-15",
    "metrics": {
        // ... actual metrics data
    }
}

出现错误时：

{
    "success": false,
    "email": "user@example.com", 
    "date": "2024-01-15",
    "error": "Error description"
}

部署

铁路部署

此服务器已配置为在Railway上部署：

1. 将您的GitHub存储库连接到Railway
2. 在铁路仪表板中设置环境变量：

- ULTRAHUMAN_AUTH_KEY - ULTRAHUMAN_BASE_URL （可选）

1. 从主分支自动部署

Docker部署

# Build the image
docker build -t ultrahuman-mcp .

# Run the container
docker run -p 8000:8000 \
  -e ULTRAHUMAN_AUTH_KEY=your_key_here \
  ultrahuman-mcp

API环境

• 生产: https://partner.ultrahuman.com/api/v1/metrics
• 暂存: https://www.staging.ultrahuman.com/api/v1/metrics

错误处理

服务器包括全面的错误处理：

• 身份验证错误：授权密钥无效或丢失
• 验证错误：电子邮件格式或日期格式无效
• API错误：来自Ultrahuman API的HTTP错误
• 网络错误：连接超时或网络问题

安全

• API密钥通过环境变量进行管理
• 所有API请求都使用HTTPS
• 没有记录或缓存敏感数据

贡献

我们欢迎捐款！请随时：

1. 分叉存储库
2. 创建要素分支： git checkout -b feature-name
3. 提交您的更改： git commit -am 'Add feature'
4. 推到分支： git push origin feature-name
5. 提交拉取请求

许可证

该项目根据MIT许可证获得许可。请参阅 许可证 文件以获取详细信息。

支持

关于以下问题：

• MCP服务器：在此存储库中打开一个问题
• 超人类API：联系超人支持
• FastMCP：检查 FastMCP文档

存储库设置

有关最大可见性和SEO优化，请参阅 有关以下内容的详细说明：

• 使用适当的标签配置GitHub About部分
• 搜索引擎的SEO优化
• 添加到MCP展示和精彩列表

链接

• 超人类API文档
• FastMCP框架
• 模型上下文协议
• 很棒的MCP -在此处添加您的项目！