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

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