ヘビーMCP

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 を自動的にインストールするには:

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

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

View all tools

Related MCP Servers

FastAPI MCP Server
purity3
-
security
A
license
-
quality
A high-performance Model Context Protocol (MCP) server designed for large language models, enabling real-time communication between AI models and applications with support for session management and intelligent tool registration.
Last updated -
2
Python
MIT License
AgentModeofficial
agentmode
A
security
F
license
A
quality
An all-in-one Model Context Protocol (MCP) server that connects your coding AI to numerous databases, data warehouses, data pipelines, and cloud services, streamlining development workflow through seamless integrations.
Last updated -
2
Python
Paws-on-MCP
hemanth
-
security
F
license
-
quality
A comprehensive Model Context Protocol (MCP) server implementing the latest MCP specification with tools, resources, prompts, and enhanced sampling capabilities that features HackerNews and GitHub API integrations for AI-powered analysis.
Last updated -
319
Python
Teambition MCP Server
shenysun
-
security
A
license
-
quality
A Model Context Protocol (MCP) server that provides AI capabilities to Teambition applications, enabling programmatic access to user management, organization data, and project collaboration features through natural language.
Last updated -
TypeScript
MIT License

View all related MCP servers

Appeared in Searches

Finding the latest documentation for various tasks or guidelines

Hevy MCP