비공식 Ultrahuman 링 MCP 서버 - AI 에이전트 통합용

이것이 무엇인가요

Ultrahuman Partner API를 래핑하는 비공식 Model Context Protocol(MCP) 서버로, AI 코딩 에이전트가 Ultrahuman Ring 및 CGM 기기의 건강 데이터를 직접 쿼리할 수 있게 합니다.

주요 기능 및 구현

이 서버는 AI 에이전트를 위해 두 가지 주요 도구를 제공합니다:

• 일일 지표: 지정된 날짜의 전체 데이터 덤프를 JSON 또는 마크다운 형식으로 반환합니다.
• 실시간 값: 단일 지표(예: 회복 점수, 수면 점수, HRV)를 빠른 상태 확인을 위해 가져옵니다.

사용 가능한 지표에는 수면 데이터, HRV, 안정 시 심박수, 걸음 수, 회복 점수, 혈당 측정값, 대사 점수, VO2 max 추정치가 포함됩니다.

설정 및 요구사항

이 프로젝트는 다음이 필요합니다:

• Python 3.10 이상
• Ultrahuman Partner API 접근 권한(앱의 "도움말 받기" 섹션을 통해 획득한 토큰)
• 인증을 위한 계정 이메일

자격 증명은 환경 변수(ULTRAHUMAN_TOKEN 및 ULTRAHUMAN_EMAIL)를 통해 독점적으로 관리되며, 하드코딩된 값은 없습니다.

호환성 및 사용 사례

이 MCP 서버는 Claude Code, Cursor, OpenClaw를 포함하여 MCP를 지원하는 AI 설정과 함께 작동합니다. 저장소에는 모델이 도구를 호출해야 할 때와 아침 브리핑, 회복 확인, 간단한 분석(주간 보기, 추세)을 위해 데이터를 제시하는 방법을 이해하도록 돕는 기술이 포함되어 있습니다.

주간 요약을 위한 차트가 포함된 PDF 보고서를 생성하는 스크립트도 제공됩니다.

프로젝트 세부사항

• 라이선스: MIT
• 저장소: https://github.com/Duzafizzl/Ultrahuman-MCP
• 상태: 커뮤니티 프로젝트, Ultrahuman과 공식적으로 제휴되지 않음