hevy-mcp: 대화형 접근을 가능하게 하는 MCP 브리지 Hevy 운동 데이터에
hevy-mcp는 Swrm Io에 의해 구축된 MCP 서버로, Hevy 운동 데이터를 AI 어시스턴트에 연결하여 대화형 쿼리 및 자동화된 루틴 작업을 가능하게 합니다. 이 도구는 Hevy API를 통해 운동 로그, 루틴 관리, 운동 템플릿 인덱스 및 신체 측정을 노출하여 모델이 훈련량을 분석하고 계획 수정을 제안할 수 있도록 합니다. 환경 변수를 사용하여 API 키를 보호하고 MCP stdio를 통해 실행됩니다. 대상 사용자는 Hevy 고객과 AI 기반 개인 트레이너를 구축하는 개발자로, 운동 데이터에 대한 프로그래밍 가능하고 쿼리 가능한 접근을 원합니다.
사용자의 Hevy 데이터에 대한 직접적인 채팅 기반 접근 및 편집을 가능하게 합니다
이 도구는 Hevy API를 MCP 지원 데이터 소스로 변환합니다, 따라서 AI 어시스턴트가 운동 정보를 가져오고 조치를 취할 수 있습니다. 지원되는 엔드포인트에는 페이지 매김된 운동 기록 및 총 수, 루틴 목록 및 업데이트, 운동 템플릿, 신체 측정 항목이 포함됩니다. 일반적인 결과는 과거 세션에 대한 대화형 쿼리와 저장된 루틴 편집으로, 사용자를 대신하여 Hevy 엔드포인트를 호출하는 어시스턴트에 의해 발행된 작업입니다.
분석 유용성은 Hevy 데이터 품질과 선택된 어시스턴트의 출력에 반영됩니다
생성된 분석은 두 가지 데이터 소스에 의존합니다: 사용자가 기록한 Hevy 로그와 해석을 생성하는 어시스턴트입니다. 커뮤니티 피드백은 특히 근육 그룹 불균형 점검 및 볼륨 분석을 실용적인 결과로 강조합니다. 이러한 결과는 훈련 결정을 위한 유용한 신호를 제공하지만, 모든 처방적 코칭 권장 사항은 원시 운동 항목이나 자격을 갖춘 코치와 대조하여 검증해야 합니다. 왜냐하면 이 도구는 독립적인 검증이 아닌 데이터를 제공하기 때문입니다.
작동을 위한 특정 환경 및 계정 전제 조건이 필요합니다
배포는 Node.js 및 MCP 도구를 요구합니다: Node.js v18 이상이 필요하며, stdio 전송을 사용하기 위해 Claude Desktop과 같은 MCP 호환 클라이언트가 있어야 합니다. API 접근을 위해 유효한 Hevy API 키와 Hevy Pro 계정이 필요합니다. 설치 옵션에는 npx 호출 또는 Node로 리포지토리를 복제하고 빌드하는 것이 포함되며, 이는 개발자 지향 설정 워크플로와 일치합니다.
개발자 워크플로에 적합하지만 데이터 라우팅은 클라이언트 및 어시스턴트 선택에 따라 다릅니다
서버는 에이전트 통합을 구축하는 개발자를 지향합니다, 그리고 이 프로젝트는 공식 Hevy 제품이 아닌 커뮤니티에서 구축되었습니다. 이는 stdio를 통해 모델 컨텍스트 프로토콜을 지원하는 모든 시스템에서 실행되도록 설계되었으므로, 데이터가 호스트를 떠나는 방법과 위치는 MCP 클라이언트 및 어시스턴트 구성에 따라 다릅니다. 서버는 API 키를 위한 환경 변수를 사용하여 통합 작업 중에 자격 증명이 소스 코드에서 벗어나도록 도와줍니다.
모델 주도 분석을 수용하는 개발자 및 Hevy 사용자들을 위한 실용적인 통합
이 도구는 운동 기록 및 앱 내 루틴 수정을 위한 대화형 접근이 필요한 개발자 및 Hevy 고객을 위한 실용적인 옵션입니다. 그 가치는 기록된 운동의 질과 해석을 생성하는 어시스턴트의 품질에 따라 달라집니다. 이 도구를 데이터 전송 수단으로 사용하고, 훈련 변경 사항을 프로그램에 적용할 때 생성된 권장 사항을 수동 검토 또는 전문가 감독과 쌍으로 사용할 것으로 기대하십시오.
