Hevy MCP

🚀 Hevy-MCP：HevyフィットネスアプリAPIインターフェースのモデルコンテキストプロトコル（MCP）サーバー

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

🚀 クイックスタート

Hevy-MCPは、HevyフィットネスアプリのAPIと連携するMCPサーバーです。これを使えば、AIアシスタントがトレーニングデータやプランを管理できます。

✨ 主な機能

• トレーニング管理：トレーニングの取得、作成、更新が可能です。
• プラン管理：トレーニングプランのアクセスと管理ができます。
• エクササイズテンプレート：利用可能なエクササイズテンプレートを閲覧できます。
• フォルダ管理：プランフォルダの管理が可能です。

📦 インストール

前提条件

• Node.js（v20以上）
• npmまたはyarn
• Hevy APIキー

Smitheryを通じたインストール

Claude DesktopにSmitheryを使って自動でhevy-mcpをインストールするには、以下のコマンドを実行します。

npx -y @smithery/cli install @chrisdoc/hevy-mcp --client claude

手動インストール

# リポジトリをクローンする
git clone https://github.com/chrisdoc/hevy-mcp.git
cd hevy-mcp

# 依存関係をインストールする
npm install

# サンプルから.envファイルを作成する
cp .env.sample .env
# .envを編集し、Hevy APIキーを追加する

Cursorとの統合

このMCPサーバーをCursorと一緒に使用するには、~/.cursor/mcp.json ファイルを更新し、以下の設定を追加します。

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

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

📚 ドキュメント

設定

プロジェクトのルートディレクトリに .env ファイルを作成し、以下の内容を記述します。

HEVY_API_KEY=your_hevy_api_key_here

your_hevy_api_key_here を実際のHevy APIキーに置き換えてください。

使用方法

インストール後

npm start # サーバーを起動する

機能モジュール

トレーニング管理

• すべてのトレーニングを取得する
• 新しいトレーニングを作成する
• 既存のトレーニングを更新する
• トレーニングを削除する

プラン管理

• すべてのプランを取得する
• 新しいプランを作成する
• 既存のプランを更新する
• プランを削除する

エクササイズテンプレート

• すべてのエクササイズテンプレートを取得する
• 新しいエクササイズテンプレートを作成する
• 既存のエクササイズテンプレートを更新する
• エクササイズテンプレートを削除する

フォルダ管理

• フォルダを作成する
• フォルダのリストを取得する
• フォルダ構造を更新する
• フォルダを削除する

プロジェクト構造

hevy-mcp/
├── src/
│   ├── index.js       # エントリーファイル
│   ├── server.js     # サーバー設定
│   └── routes/       # ルートモジュール
│       ├── workouts.js    # トレーニングルート
│       ├── plans.js      # プランルート
│       └── templates.js  # エクササイズテンプレートルート
├── public/
│   └── .env          # 環境変数ファイル
└── package.json     # 依存関係管理

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。詳細はLICENSEファイルを参照してください。

🔗 貢献

貢献を歓迎します！自由にPull Requestを送信してください。

🙏 謝辞

• モデルコンテキストプロトコル のMCP SDK
• Hevy のフィットネストラッキングプラットフォームとAPI