Hevy MCP Server

🚀 希弗 MCP サーバー

このサーバーは TypeScript と Node.js で作成されており、希弗（Hevy）のフィットネスデータをモデルコンテキストプロトコル（MCP）を通じて言語モデルに接続します。このサーバーは希弗 API からデータを取得し、トレーニング履歴、トレーニングの進捗状況、ベスト記録にアクセスするためのツールを提供します。

🚀 クイックスタート

この希弗 MCP サーバーを使用することで、希弗のフィットネスデータを言語モデルと接続し、トレーニング履歴や進捗状況を分析することができます。

希弗 API キーの取得

希弗 API キーを取得するには、Hevy API ドキュメント にアクセスし、認証の説明に従ってください。希弗開発者ポータルサイトで登録して API アクセス権を取得する必要があります。

Cursor への追加

この MCP サーバーを Cursor に追加するには、~/.cursor/mcp.json ファイルを以下のように更新してください。

"hevy-mcp-server": {
  "command": "npx",
  "args": ["-y", "@vreippainen/hevy-mcp-server", "--stdio"],
  "env": {
    "HEVY_API_KEY": "your-api-key-here"
  }
}

your-api-key-here を実際の希弗 API キーに置き換えてください。

✨ 主な機能

モデルコンテキストプロトコル（MCP）の利用

モデルコンテキストプロトコル（MCP）は、claude のような大規模言語モデル（LLMs）を外部データソースやツールと統合するための標準です。この MCP サーバーにより、AI アシスタントが希弗のフィットネスデータにアクセスし、分析することが可能になります。

利用可能なツール

この MCP サーバーは以下のツールを提供します。

• get-workouts：指定した開始日と終了日の間のトレーニング記録を取得します。日付の降順でトレーニングを返し、持続時間と総量の統計情報を含みます。最大 10 件の記録を表示します。
• get-exercise-progress-by-ids：特定のトレーニングの一定期間の進捗状況を追跡します。各セットの最大値記録も含まれます。
• get-exercises：包括的なトレーニングデータを取得します。デフォルトでは使用頻度で並べられ、名前や日付範囲などのフィルターを選択できます。実際および推定の 1 回最大筋力（1RM）も含まれます。
• get-routines：保存されたトレーニングプランを取得します。

スマートトレーニングヒントビルダー

このサーバーにはスマートトレーニングヒントビルダーが含まれており、以下のことを行います。

• 最も頻繁に使用するトレーニングとその推定 1RM を分析します。
• 詳細なトレーニング情報と保存されたトレーニングプランをリストします。
• AI アシスタントが過去の記録に基づいて個別のトレーニング提案を作成するのを支援します。

📚 ドキュメント

リソースドキュメント

サーバーはすべての利用可能なツールの詳細なドキュメントを提供しており、専用のリソースエンドポイントからアクセスできます。このドキュメントには以下が含まれます。

• 詳細なパラメーターの説明
• パラメーターの有効範囲とデフォルト値
• サンプルの使用シナリオ

技術ドキュメント

インストール、設定、サーバーの実行、API エンドポイント、サービスメソッド、およびプロジェクト構造に関する詳細な技術情報については、TECHNICAL.md を参照してください。

🔧 技術詳細

このプロジェクトは semantic-release を使用して自動化されたバージョン管理とパッケージのリリースを行っています。コミットメッセージは Conventional Commits 規範に従っています。