CH

chrisdoc/hevy-mcp

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る

528 stars 96 forks 品質 91 トレンド 43MIT

ヘビーワークアウト、ルーティン、フォルダ、エクササイズテンプレートを管理しましょう。セッションの作成と更新を迅速にし、計画を整理し、エクササイズを検索して素早くトレーニングを組み立てましょう。

概要

Hevy-mcPは、Claude DesktopやCursorなどのMCP互換アシスタントをHevyフィットネスAPIに接続します。ワークアウト履歴について質問したり、進捗を分析したり、ルーティンやエクササイズを閲覧したり、アシスタントを離れずにHevyのデータを作成・更新したりできます。 Hevy PROで利用可能なHevy APIキーが必要です。 MCPクライアントがコマンドを起動できるときはローカルのstdioを使いましょう。ホストされたStreamable HTTPの設定は以下に記載されていますが、一時的に利用できません。 npmパッケージと公式コンテナはMCP実行ファイルです。クライアントがプロセスを開始し、標準的な入出力を通じて通信します。これはインタラクティブなターミナルコマンドやHTTPサービスではありません。 パッケージのメタデータで宣言される20 Node.js以降が必要です。 Claude Desktop(claude_desktop_config.json)とCursor(~/.cursor/mcp.json)は、以下のようにmcpServersのエントリを受け入れています: - ~/ライブラリ/アプリケーションサポート/Claude/claude_desktop_config.json - %APPDATA%\Claude\claude_desktop_config.json バンが必要だ。

概要(AI 翻訳)

Claude、Cursor、Codex、その他のMCPクライアントからHevyのワークアウトデータと話してください。

ホストされたMCPに接続・Hevy CLIの使用 ·18秒のデモを見る ·23のツールすべてを探索 ·ドキュメント

重いCLIだ

ターミナルの方がいいですか?別々の方がいいです @chrisdoc/hevy-cli パッケージはワークアウト、ルーティン、運動、体のサイズを直接読み取っています Hevy APIから、明示的な 確認。削除はサポートされていません。

スクリプトやパイプラインの任意のコマンドに--jsonを追加してください。CLIはスタンドアロンです 重いAPIクライアントで、MCPラッパーではありません。参照 packages/cli/README.md は完全な指揮権を用いる 参照コード、ページ表示動作、出口コード。

hevy-mcpはオープンソースのモデルコンテキストプロトコル(MCP)です ヘビーフィットネスとトレーニングトラッキングのサーバー アプリ。AIアシスタントがあなたのヘビーワークアウトを読み、分析し、作成し、更新できるようにします。 ルーティン、エクササイズテンプレート、ボディサイズを認証済みHevyで提供 APIリクエスト。

Nodeのstdio/HTTPアダプターとCloudflare Workerは同じMCPツールを共有しています。 輸送手段を選択するには展開モードを参照、または ワークスペース所有権のアーキテクチャ、ランタイムスコープ、 そして組み込みAPIをサポートしていました。

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。

README

以下は原文 README の抜粋です。原文を見る。

Hevy MCP Server

Hevy CLI

Prefer the terminal? The separate @chrisdoc/hevy-cli package reads workouts, routines, exercises, and body measurements directly from the Hevy API, and can create or update those resources with explicit confirmation. Deletion is not supported.

npm install -g @chrisdoc/hevy-cli
export HEVY_API_KEY=your-hevy-api-key

hevy workouts list --page-size 10
hevy summary --weeks 4

Add --json to any command for scripts and pipelines. The CLI is a standalone Hevy API client, not an MCP wrapper. See packages/cli/README.md for the full command reference, pagination behavior, and exit codes.

hevy-mcp is an open-source Model Context Protocol (MCP) server for the Hevy fitness and workout tracking app. It lets AI assistants read, analyze, create, and update your Hevy workouts, routines, exercise templates, and body measurements through authenticated Hevy API requests.

The Node stdio/HTTP adapter and Cloudflare Worker share the same MCP tools. See deployment modes to choose a transport, or architecture for workspace ownership, runtime scopes, and supported embedding APIs.

A Hevy API key, available with Hevy PRO, is required.

See it in action

GitHub で README 全文を見る

インストール

npx -y hevy-mcp
MCP 初心者?mcpskill.org のガイドから始めましょう →

設定

{ "mcpServers": { "hevy": { "url": "https://mcp.hevy-mcp.dev/mcp", "headers": { "Authorization": "Bearer your-hevy-api-key" } } } }