hevy-mcp

hevy-mcp: Cầu MCP cho phép truy cập hội thoại vào dữ liệu tập luyện Hevy

hevy-mcp, được xây dựng bởi Swrm Io, là một máy chủ MCP kết nối dữ liệu tập luyện Hevy với các trợ lý AI, cho phép truy vấn hội thoại và các hành động tự động trong thói quen. Công cụ này cung cấp nhật ký tập luyện, quản lý thói quen, chỉ mục mẫu bài tập và số đo cơ thể thông qua Hevy API để các mô hình có thể phân tích khối lượng tập luyện và đề xuất chỉnh sửa kế hoạch. Nó bảo mật khóa API bằng các biến môi trường và chạy qua MCP stdio. Người dùng mục tiêu là khách hàng Hevy và các nhà phát triển xây dựng huấn luyện viên cá nhân được hỗ trợ bởi AI, những người muốn truy cập dữ liệu tập luyện theo cách lập trình và có thể truy vấn.

Kích hoạt quyền truy cập và chỉnh sửa dữ liệu Hevy của người dùng thông qua trò chuyện trực tiếp

Công cụ biến API Hevy thành một nguồn dữ liệu hỗ trợ MCP, để các trợ lý AI có thể lấy và hành động dựa trên thông tin tập luyện. Các điểm cuối được hỗ trợ bao gồm lịch sử tập luyện phân trang và tổng số, danh sách và cập nhật thói quen, mẫu bài tập, và các mục đo lường cơ thể. Kết quả điển hình là các truy vấn hội thoại về các phiên trước đó và chỉnh sửa thói quen đã lưu, với các hành động được thực hiện bởi một trợ lý gọi các điểm cuối Hevy thay mặt người dùng.

Phân tích tính hữu ích phản ánh chất lượng dữ liệu Hevy và đầu ra của trợ lý đã chọn

Phân tích được tạo ra phụ thuộc vào hai nguồn dữ liệu: nhật ký Hevy đã ghi lại của người dùng và trợ lý sản xuất sự diễn giải. Phản hồi từ cộng đồng đặc biệt nhấn mạnh việc kiểm tra sự mất cân bằng nhóm cơ và phân tích khối lượng như là những đầu ra thực tiễn. Những kết quả đó cung cấp tín hiệu có thể sử dụng cho các quyết định tập luyện, nhưng bất kỳ khuyến nghị huấn luyện nào cũng nên được xác minh với các mục nhập tập luyện thô hoặc một huấn luyện viên đủ tiêu chuẩn, vì công cụ cung cấp dữ liệu thay vì xác thực độc lập.

Cần môi trường cụ thể và yêu cầu tài khoản để hoạt động

Triển khai yêu cầu Node.js và công cụ MCP: yêu cầu Node.js v18 trở lên, và một khách hàng tương thích với MCP như Claude Desktop phải có mặt để sử dụng giao thức stdio. Một khóa API Hevy hợp lệ và một tài khoản Hevy Pro là cần thiết để truy cập API. Các tùy chọn cài đặt bao gồm gọi npx hoặc sao chép và xây dựng kho lưu trữ với Node, điều này phù hợp với quy trình thiết lập hướng tới nhà phát triển.

Phù hợp với quy trình làm việc của nhà phát triển nhưng việc định tuyến dữ liệu phụ thuộc vào lựa chọn của khách hàng và trợ lý

Máy chủ được định hướng cho các nhà phát triển xây dựng tích hợp đại lý, và dự án được xây dựng bởi cộng đồng thay vì là sản phẩm chính thức của Hevy. Nó được thiết kế để chạy trên bất kỳ hệ thống nào hỗ trợ Giao thức Ngữ cảnh Mô hình thông qua stdio, vì vậy cách và nơi dữ liệu rời khỏi máy chủ phụ thuộc vào cấu hình khách hàng và trợ lý MCP. Máy chủ sử dụng các biến môi trường cho các khóa API, điều này giúp giữ thông tin xác thực ra khỏi mã nguồn trong quá trình tích hợp.

Một sự tích hợp thực tiễn cho các nhà phát triển và người dùng Hevy chấp nhận phân tích theo mô hình

Công cụ này là một lựa chọn thực tiễn cho các nhà phát triển và khách hàng Hevy cần truy cập hội thoại vào hồ sơ tập luyện và chỉnh sửa thói quen trong ứng dụng; giá trị của nó phụ thuộc vào chất lượng của các bài tập đã ghi lại và trợ lý sản xuất các diễn giải. Hãy mong đợi sử dụng công cụ này như một kênh dữ liệu và kết hợp các khuyến nghị được tạo ra với việc xem xét thủ công hoặc giám sát của chuyên gia khi áp dụng các thay đổi đào tạo cho một chương trình.