chrisdoc/hevy-mcp

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

529 stars 96 forks Качество 91 Тренд 41MIT

Управляйте своими тренировками, рутинами, папками и шаблонами упражнений Hevy. Быстрее создавайте и обновляйте занятия, организуйте планы и ищите упражнения для быстрого наращивания тренировок.

Обзор

hevy-mcp подключает совместимых с MCP ассистентов, таких как Claude Desktop и Cursor, с фитнес-API Hevy. Спрашивайте об истории тренировок, анализируйте прогресс, просматривайте программы и упражнения, либо создавайте и обновляйте данные Hevy, не выходя из ассистента. Требуется ключ Hevy API, доступный в Hevy PRO. Используйте локальный stdio, когда ваш MCP-клиент может запустить команду. Настройка Hosted Streamable HTTP описана ниже, но временно недоступна. Пакет npm и официальный контейнер — это исполняемые файлы MCP. Ваш клиент запускает процесс и общается через стандартный ввод/вывод; это не интерактивная команда терминала и не HTTP-сервис. Требуется Node.js 20 или новее, как указано в метаданных пакета. Claude Desktop (claude_desktop_config.json) и Cursor (~/.cursor/mcp.json) оба принимают записи mcpServers, как следующее: - ~/Библиотека/Поддержка приложений/Claude/claude_desktop_config.json - %APPDATA%\Claude\claude_desktop_config.json Нужен Бун.

Обзор (машинный перевод)

Поговорите с данными о тренировках Hevy от Claude, Cursor, Codex и других клиентов MCP.

Подключитесь к размещённому MCP · Используйте Hevy CLI · Смотрите 18-секундную демонстрацию · Исследуйте все 23 инструмента · Документация

Хеви CLI

Предпочитаете терминал? Отдельный @chrisdoc/hevy-cli Пакет напрямую читает тренировки, программы, упражнения и измерения тела из Hevy API и может создавать или обновлять эти ресурсы с помощью явных Подтверждение. Удаление не поддерживается.

Добавьте --json к любой команде скриптов и конвейеров. CLI является автономным Клиент Hevy API, а не MCP-обёртка. См. packages/cli/README.md для полного командования ссылки, поведение страниц и коды выхода.

hevy-mcp — это открытый протокол контекста модели (MCP) сервер для отслеживания фитнеса и тренировок Hevy приложение. Оно позволяет ассистентам ИИ читать, анализировать, создавать и обновлять ваши тренировки Hevy, рутины, шаблоны упражнений и измерения тела через подтверждённый Hevy API-запросы.

Адаптер Node stdio/HTTP и Cloudflare Worker используют одни и те же MCP-инструменты. См. режимы развертывания для выбора транспорта, или архитектура для владения рабочим пространством, область выполнения задач, и поддерживали встроенные API.

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

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

Открыть полный README на GitHub

Установка

npx -y hevy-mcp

Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

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