exerciseapi

@exerciseapi/mcp-server

exerciseapi.dev の公式 MCP サーバーです。AI コーディングエージェントから、12 カテゴリーにわたる審査済みの 2,198 件以上のエクササイズに直接アクセスできます。

Claude Code、Cursor、Windsurf、Cline を使ってフィットネス、ワークアウト、トレーニング、リハビリ、ウェルネスのアプリを開発していますか？ エージェントにエクササイズのデータをでっち上げさせるのはやめましょう。この MCP サーバーをインストールすると、exerciseapi.dev のライブラリから実際の構造化されたエクササイズを取得する 6 つのツールをエージェントが使えるようになります。

このサーバーが作られた理由

LLM はエクササイズの手順を幻覚します。筋肉群をでっち上げたり、フォームのポイントを混同したりします。「リバースグリップ・インクライン・ケーブルフライ」を勧め、安全上の注意まで添えて人を傷つけかねません。

このサーバーを使うと、エージェントは次の情報にアクセスできます。

• 2,198 件以上のエクササイズ。筋力トレーニング、カリステニクス、ヨガ、ピラティス、モビリティ、理学療法、プライオメトリクス、ストレッチなどを網羅
• 実際の解剖学的な筋肉データ。主働筋と補助筋を具体的に記載。「胸」や「脚」だけではありません
• 人が作成したフォームのポイントと安全上の注意。自動生成ではありません
• 器具、難易度、カテゴリーのフィルター。エージェントが正確なワークアウトを作成できます
• デモ動画。対象となるエクササイズは増え続けています

exerciseapi.dev REST API を薄くラップしたものです。フィルタリングと検索はすべてサーバー側で実行され、MCP レイヤーはそれらをツールとして呼び出せるようにするだけです。

インストール

1. 無料の API キーを取得する

exerciseapi.dev/dashboard で登録してください。無料プランでは 1 日 100 リクエストを利用でき、開発には十分です。クレジットカードは不要です。

2. MCP クライアントに追加する

Claude Desktop / Claude Code — ~/.config/claude/claude_desktop_config.json（またはプロジェクトの .mcp.json）に追加します。

{
  "mcpServers": {
    "exerciseapi": {
      "command": "npx",
      "args": ["-y", "@exerciseapi/mcp-server"],
      "env": {
        "EXERCISEAPI_KEY": "exlib_your_key_here"
      }
    }
  }
}

Cursor — プロジェクトの .cursor/mcp.json に追加します。

{
  "mcpServers": {
    "exerciseapi": {
      "command": "npx",
      "args": ["-y", "@exerciseapi/mcp-server"],
      "env": {
        "EXERCISEAPI_KEY": "exlib_your_key_here"
      }
    }
  }
}

Windsurf、Cline、Zed — 同じ形式で、クライアントの MCP 設定に貼り付けてください。

3. エージェントを再起動する

Claude Desktop / Cursor / Windsurf を再起動して、新しいサーバーを読み込ませてください。これで完了です。

試してみる

インストール後、エージェントに次のように尋ねてみてください。

ダンベルだけでできる、中級者向けの胸のエクササイズを 5 つ探してください。それぞれフォームのポイントも教えてください。

エージェントは適切なフィルターを指定して search_exercises を呼び出し、実際のデータを取得して、ライブラリに基づく正確なエクササイズを回答します。幻覚はありません。

または、次のように尋ねてみてください。

初心者向けの全身ワークアウトアプリを作っています。器具不要のエクササイズを、プッシュ、プル、脚から 8 つ取得してください。

または、次のように尋ねてみてください。

筋肉の働きという点で、バーベルベンチプレスとダンベルベンチプレスにはどのような違いがありますか？

ツール

このサーバーは 6 つのツールを公開します。

ツール	機能
search_exercises	名前、カテゴリー、筋肉、器具、難易度からライブラリを検索します。最大 100 件のエクササイズを返します。
get_exercise	ID を指定して単一のエクササイズの詳細（手順、フォームのポイント、安全上の注意、バリエーション、動画）を取得します。
list_categories	件数付きで、12 のエクササイズカテゴリーをすべて一覧表示します。
list_muscles	フィルターとして利用できる解剖学的な筋肉を一覧表示します。
list_equipment	フィルターとして利用できる器具の種類を一覧表示します。
get_stats	ライブラリ全体の統計情報（総数、カテゴリー別の内訳、動画の収録状況）を取得します。

ツールの詳細はこちらの MCP ドキュメントページをご覧ください。

exerciseapi.dev を選ぶ理由

	exerciseapi.dev	ExerciseDB	free-exercise-db	API Ninjas
エクササイズ数	2,198（目標：10,000以上）	約1,300	約800	約3,000
カテゴリー	12（筋力トレーニング、ヨガ、PT、モビリティ、ピラティスなど）	筋力トレーニングのみ	筋力トレーニングのみ	7種類
検索キーワード	✅ エクササイズごとに5～10個	❌	❌	❌
フォームのヒント	✅ エクササイズごとに3～4個	❌	❌	❌
安全上の注意	✅ 詳細	❌	❌	基本的な内容
具体的な解剖学的筋肉	✅	✅	❌	❌
バリエーション	✅ エクササイズごとに3～5種類	❌	❌	❌
デモ動画	✅ 拡充中	✅ GIF	❌	❌
MCP サーバー	✅ このパッケージ	❌	❌	❌
無料プラン	1日あたり100リクエスト	なし	該当なし（静的）	1か月あたり100リクエスト
有料プランの開始価格	月額$5	月額$10	—	月額$10

AI コーディングエージェントを利用する開発者のために特別に構築されています。スキーマ、ツールの説明、ドキュメントの形式はすべて、LLM が初回から正しく理解して使えるように設計されています。

設定

必須の環境変数

変数	説明
EXERCISEAPI_KEY	exerciseapi.dev/dashboardで取得した API キーです。必須です。設定されていない場合、サーバーは起動時に終了します。

任意の環境変数

変数	デフォルト値	説明
EXERCISEAPI_BASE_URL	https://api.exerciseapi.dev	API のベース URL を上書きします。セルフホストやステージング環境に対するテストに便利です。

トラブルシューティング

「EXERCISEAPI_KEY environment variable not set」 MCP クライアントの設定にキーを追加し忘れたか、追加後にクライアントを再起動していません。設定ファイル内の JSON を確認し、再起動してください。

「API key is invalid」 キーが拒否されました。exerciseapi.dev/dashboardで新しいキーを生成し、設定を更新してください。

「Daily quota reached」 無料プランの1日あたり100リクエストの上限に達しました。翌日（UTC の午前0時にリセット）まで待つか、exerciseapi.dev/pricingでプランをアップグレードしてください。

エージェントがツールを使わない よくある原因は2つあります。（1）サーバーが起動していません。クライアントの MCP サーバーのログを確認してください。通常は開発者コンソールまたはログファイルにあります。（2）エージェントがツールを関連性のあるものと判断していません。「exerciseapi ツールを使って、…を探してください」のように、より明確に依頼してみてください。

初回実行時のコールドスタートが遅い npx -y @exerciseapi/mcp-serverは、初回使用時にパッケージをダウンロードします。再起動のたびにダウンロードするのを避けるには、npm install -g @exerciseapi/mcp-serverでグローバルにインストールし、設定内のcommandをexerciseapi-mcpに変更してください。

MCP を使わずに直接 API にアクセス

MCP ではなく REST API を直接利用したい場合（たとえば、サーバーサイドの統合を構築する場合や、対応する MCP クライアントを使用していない場合）は、exerciseapi.dev/docsをご覧ください。同じ API キーをどちらにも使用できます。

また、ランディングページにある汎用のコピー＆ペースト用プロンプトを、任意の AI コーディングツールに貼り付ければ、MCP を使わずにすぐに動作する統合を作成できます。

コントリビューション

Issue や PR を歓迎します。このサーバーは意図的に薄いラッパーとして作られています。変更したいロジックがある場合は、おそらく REST API（プライベートリポジトリ）に実装するのが適切です。判断に迷う場合は、まず Issue を作成してください。

ライセンス

MIT © Vegh Labs LLC

---

West Veghが作成しました。エクササイズデータ基盤の構築に費やす週末を節約できたら、ダッシュボードで気軽にお声がけください。または [email protected] までご連絡ください。