このプロジェクトについて

Hevy MCP Serverは、フィットネスおよびワークアウト追跡アプリHevy向けのオープンソースModel Context Protocol(MCP)サーバーです。認証済みのHevy APIリクエストを通じて、AIアシスタントがHevyのワークアウト、ルーティン、エクササイズテンプレート、体組成を読み取り、分析し、作成、更新できるようにします。Hevy PROで利用可能なHevy APIキーが必要です。 このサーバーは、トレーニング分析、ワークアウト、ルーティン、ルーティンフォルダ、エクササイズテンプレート、エクササイズ履歴、体組成、診断などのカテゴリにわたる23のツールを登録します。読み取り専用ツールは探索をサポートし、作成および更新ツールはMCPのミューテーションアノテーション付きで公開されるため、対応クライアントは確認を要求できます。Hevy APIは現在削除エンドポイントを公開していないため、削除ツールは提供されていません。 ユーザーは、https://mcp.hevy-mcp.dev/mcp のホスト型Cloudflare Streamable HTTPエンドポイントを通じて接続できます。この場合、Hevy APIキーをベアラートークンとして送信する必要があります。または、npx、bunx、Dockerを使ってローカルで実行できます。ホスト型エンドポイントは、固定ヘッダーを送信できないClaude.aiなどのクライアント向けにOAuth 2.1をサポートしています。別個のCLIパッケージ@chrisdoc/hevy-cliは、ワークアウト、ルーティン、エクササイズ、体組成へのターミナルアクセスを提供します。 リポジトリはワークスペースとして構成され、Hevyクライアント、ドメイン操作、MCPコア、Node.js stdioアダプタ、Cloudflare Workerアダプタ、スタンドアロンCLI用のパッケージが含まれています。公開されているHevyClientはPromiseベースですが、内部操作ではリトライスケジュール、タイムアウト、割り込み処理にEffectを使用しています。ツールの入力およびレスポンスのコントラクトにはZodスキーマを使用しています。