Install
npx -y delx-wellness-hermes setup누구에게 맞나
이미 Fitbit, Pixel Watch 또는 Google Health 파트너를 쓰고, 이 머신에서 OAuth로 자신이 인가한 Health API v4 데이터를 읽고 싶은 사람에게 맞다. 공식은 local-first라고 적었고, 토큰은 이 머신을 떠나지 않는다. 현재는 Beta다.
권장 설치는 Hermes를 향한다. 한 명령이 이 커넥터와 다른 8개를 전용 Hermes 설정에 미리 구성한다. 출처 제목은 Claude와 Cursor도 적었다. 건강 데이터가 Google로 나가는 것은 받아들이되 토큰은 이 머신에 남기는 사람에게 맞다.
OAuth를 완료할 수 없거나, 건강 관련 요청이 이 머신을 떠나는 것을 원하지 않으면 이 가이드는 도움이 되지 않는다. 현재 설명은 구체 MCP 도구(예: 걸음 수나 심박수)를 지목하지 않았다. 도구 이름을 스스로 채우지 말 것.
3분 만에 첫 시도 끝내기
전제: 이 머신에서 npx를 실행할 수 있고, Hermes를 쓸 예정(또는 나중에 다른 클라이언트에 연결). 공식 원클릭 설치는:
npx -y delx-wellness-hermes setup
이는 Delx Wellness for Hermes에서 온다.
https://github.com/davidmosiah/delx-wellness-hermes
이 커넥터와 다른 8개를 미리 구성한다. 첫 시도에서 clinical scope를 열지 말 것.
첫 시도는 지목된 읽기 전용 명령 coverage를 쓴다. OAuth 전 정적 사전 검사는 coverage --json으로 적혀 있으며 --live를 붙이지 말 것. 전체 패키지 이름이 있는 공식 예는 실제 계정 버전만 보여 준다.
npx -y google-health-mcp-unofficial coverage --live --json
첫 시도는 같은 패키지에서 coverage --json을 먼저 실행한다. 관찰 가능한 성공 신호: coverage 보고서가 나오고 OAuth 비밀, 로컬 경로, 원시 건강 측정값이 보이지 않아야 한다. 공식은 그 목표로 설계되었다고 적었다. 네트워크 의존성에는 여전히 닿을 수 있으니 "네트워크 없음, 프라이버시 경계 없음"으로 이해하지 말 것. 사전 검사가 통과한 뒤 실제 계정을 치려면 --live를 더한다. 그것도 읽기 전용이지만 실제 계정에 닿는다. 시작 전에 쓸 계정이 자신의 인가 계정인지 확인한다.
SSH / 컨테이너 / WSL은 auth --manual로 헤드리스 OAuth를 할 수 있다. 그것은 첫 시도가 갈 길이 아니다.
사용 사례
사례 1: 배선 전에 커버리지를 본다. coverage --json을 실행해 OAuth 전에 정적 사전 검사를 한다. 발췌는 보고서 필드를 나열하지 않았으므로 성공은 "JSON 커버리지를 얻고 비밀과 원시 측정이 보이지 않는 것"이다. 사전 검사 결과를 Fitbit에 이미 연결된 것으로 보지 말 것.
사례 2: 실제 계정에 대한 읽기 전용 대조. npx -y google-health-mcp-unofficial coverage --live --json을 실행한다. 공식은 읽기 전용이라고 적었고 OAuth 비밀, 로컬 경로, 원시 건강 측정을 의도적으로 생략한다. 발췌는 필터 파라미터나 시간 창을 주지 않았다. 이 출력을 임상 기록으로 보지 말 것. clinical scope(ECG/IRN)는 선택 개방이며 첫 사례에서는 열지 말 것.
사용 경계
비공식 npm 패키지 이름은 google-health-mcp-unofficial이고 상태는 Beta다. 토큰은 이 머신에 남아야 하지만 Health API 요청은 이 머신을 떠난다. coverage는 원시 측정을 생략하도록 설계되었으며, 데이터가 한 번도 요청되지 않았다는 뜻은 아니다. 인가 철회, 로컬 토큰 삭제, Hermes 설정 끄기 단계는 쓰지 않았다. 함께 미리 구성되는 다른 8개 커넥터는 지목되지 않았다. 공식 저장소:
https://github.com/davidmosiah/google-health-mcp