hevy-mcp: Hevy Fitness API 用モデルコンテキストプロトコルサーバー

HevyフィットネストラッキングアプリとそのAPIと連携するモデルコンテキストプロトコル（MCP）サーバー実装。このサーバーにより、AIアシスタントはHevy API（PROサブスクリプションが必要）を介してワークアウトデータ、ルーチン、エクササイズテンプレートなどにアクセスし、管理できるようになります。

特徴

• ワークアウト管理: ワークアウトの取得、作成、更新

• ルーチン管理: トレーニングルーチンにアクセスして管理する

• エクササイズテンプレート: 利用可能なエクササイズテンプレートを参照します

• フォルダの整理: 日常的なフォルダを管理する

前提条件

• Node.js (v20以上)

• npmまたはyarn

• Hevy APIキー

インストール

Smithery経由でインストール

Smithery経由で Claude Desktop 用の hevy-mcp を自動的にインストールするには:

手動インストール

カーソルとの統合

この MCP サーバーを Cursor で使用するには、次の構成を追加して~/.cursor/mcp.jsonファイルを更新する必要があります。

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

構成

プロジェクト ルートに次の内容の.envファイルを作成します。

your_hevy_api_key_here実際の Hevy API キーに置き換えます。

使���法

発達

これにより、ホット リロードを使用して MCP サーバーが開発モードで起動します。

生産

利用可能なMCPツール

サーバーは次の MCP ツールを実装します。

トレーニングツール

• get-workouts : ワークアウトデータを取得してフォーマットする

• get-workout : IDで単一のワークアウトを取得する

• create-workout : 新しいワークアウトを作成する

• update-workout : 既存のワークアウトを更新する

• get-workout-count : ワークアウトの合計数を取得する

• get-workout-events : ワークアウトの更新/削除イベントを取得する

日常的なツール

• get-routines : ルーチンデータを取得してフォーマットする

• create-routine : 新しいルーチンを作成する

• update-routine : 既存のルーチンを更新する

• get-routine : IDで単一のルーチンを取得する

演習テンプレートツール

• get-exercise-templates : エクササイズテンプレートを取得する

• get-exercise-template : IDでテンプレートを取得する

ルーチンフォルダーツール

• get-routine-folders : ルーチンフォルダを取得する

• create-routine-folder : 新しいフォルダを作成する

• get-routine-folder : IDでフォルダを取得する

プロジェクト構造

発達

コードスタイル

このプロジェクトでは、コードのフォーマットとリンティングに Biome を使用します。

APIクライアントの生成

API クライアントは、Kiota を使用して OpenAPI 仕様から生成されます。

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細については LICENSE ファイルを参照してください。

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。

謝辞

• MCP SDK のモデルコンテキストプロトコル

• HevyのフィットネストラッキングプラットフォームとAPI