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

Name: Hevy MCP
Author: chrisdoc

ライセンス: MIT 鍛冶屋のバッジ

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

特徴

ワークアウト管理: ワークアウトの取得、作成、更新
ルーチン管理: トレーニングルーチンにアクセスして管理する
エクササイズテンプレート: 利用可能なエクササイズテンプレートを参照します
フォルダの整理: 日常的なフォルダを管理する

Related MCP server: AgentMode

前提条件

Node.js (v20以上)
npmまたはyarn
Hevy APIキー

インストール

Smithery経由でインストール

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

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

手動インストール

# Clone the repository git clone https://github.com/chrisdoc/hevy-mcp.git cd hevy-mcp # Install dependencies npm install # Create .env file from sample cp .env.sample .env # Edit .env and add your Hevy API key

カーソルとの統合

この 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 run dev

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

生産

npm run build npm start

利用可能な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でフォルダを取得する

プロジェクト構造

hevy-mcp/ ├── .env # Environment variables (API keys) ├── src/ │ ├── index.ts # Main entry point │ ├── tools/ # Directory for MCP tool implementations │ │ ├── workouts.ts # Workout-related tools │ │ ├── routines.ts # Routine-related tools │ │ ├── templates.ts # Exercise template tools │ │ └── folders.ts # Routine folder tools │ ├── generated/ # API client (generated code) │ │ ├── client/ # Kiota-generated client │ └── utils/ # Helper utilities │ ├── formatters.ts # Data formatting helpers │ └── validators.ts # Input validation helpers ├── scripts/ # Build and utility scripts └── tests/ # Test suite

発達

コードスタイル

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

npm run check

APIクライアントの生成

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

npm run export-specs npm run build:client

ライセンス

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

貢献

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

謝辞

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

One-click Deploy

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

How are these scores calculated?

Hevy MCP