hevy-mcp

Python-сервер Model Context Protocol (MCP) для API фитнес-приложения Hevy. Предоставляет Claude (или любому другому ИИ, совместимому с MCP) полный доступ к вашим данным о тренировках в Hevy — записывайте тренировки, управляйте программами, отслеживайте параметры тела и многое другое.

Возможности

• 25 инструментов, охватывающих каждый эндпоинт API Hevy

• Без этапа сборки — чистый Python, просто установите и запустите

• Полный CRUD — создание, чтение, обновление тренировок, программ, шаблонов упражнений, папок, измерений и вебхуков

Инструменты

Требования

• Python 3.10+

• Аккаунт Hevy Pro (необходим для доступа к API)

• API-ключ с hevy.com/settings?developer

Установка

git clone https://github.com/YOUR_USERNAME/hevy-mcp
cd hevy-mcp
pip install -r requirements.txt

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

Claude Desktop

Добавьте в claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "hevy": {
      "command": "python",
      "args": ["/absolute/path/to/hevy-mcp/server.py"],
      "env": {
        "HEVY_API_KEY": "your-api-key-here"
      }
    }
  }
}

Перезапустите Claude Desktop. Вы должны увидеть сервер Hevy в списке под значком инструментов в чате.

Переменная окружения

В качестве альтернативы установите HEVY_API_KEY в вашем окружении и запустите напрямую:

export HEVY_API_KEY=your-api-key-here
python server.py

Примеры использования

После подключения вы можете спрашивать Claude о следующем:

• "Покажи мои последние 5 тренировок"

• "Запиши тренировку груди, которую я сделал сегодня — жим лежа 3x8 с весом 100 кг, жим гантелей на наклонной скамье 3x10 с весом 30 кг"

• "Создай программу Push/Pull/Legs"

• "Каков тренд моего веса за последний месяц?"

• "Найди ID шаблона упражнения для румынской тяги"

• "Покажи все мои подходы в жиме лежа за последние 3 месяца"

Технологический стек

• FastMCP — фреймворк для Python MCP-серверов

• httpx — HTTP-клиент

• Hevy API — официальный REST API

Лицензия

MIT