hevy-mcp: сервер протокола контекста модели для API Hevy Fitness

Реализация сервера Model Context Protocol (MCP), которая взаимодействует с приложением для отслеживания фитнеса Hevy и его API . Этот сервер позволяет помощникам на основе ИИ получать доступ и управлять данными тренировок, программами, шаблонами упражнений и многим другим через API Hevy (требуется подписка PRO).

Функции

• Управление тренировками : получение, создание и обновление тренировок.

• Управление рутиной : доступ и управление рутиной тренировок

• Шаблоны упражнений : просмотрите доступные шаблоны упражнений.

• Организация папок : управление папками рутинных задач

Related MCP server: AgentMode

Предпосылки

• Node.js (v20 или выше)

• npm или пряжа

• Ключ API Hevy

Установка

Установка через Smithery

Чтобы автоматически установить hevy-mcp для Claude Desktop через Smithery :

Ручная установка

Интеграция с курсором

Чтобы использовать этот сервер MCP с Cursor, вам необходимо обновить файл ~/.cursor/mcp.json , добавив следующую конфигурацию:

Обязательно замените your-api-key-here на ваш фактический ключ API Hevy.

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

Создайте в корне проекта файл .env со следующим содержимым:

Замените your_hevy_api_key_here на ваш фактический ключ API Hevy.

Использование

Разработка

Это запустит сервер MCP в режиме разработки с горячей перезагрузкой.

Производство

Доступные инструменты 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 : Получить одну процедуру по идентификатору

Инструменты шаблонов упражнений

• get-exercise-templates : Получить шаблоны упражнений

• get-exercise-template : Получить шаблон по ID

Инструменты для папок рутины

• get-routine-folders : Извлечь папки рутины

• create-routine-folder : Создать новую папку

• get-routine-folder : Получить папку по идентификатору

Структура проекта

Разработка

Стиль кода

В этом проекте для форматирования и линтинга кода используется Biome:

Создание API-клиента

Клиент API создается на основе спецификации OpenAPI с использованием Kiota:

Лицензия

Данный проект лицензирован по лицензии MIT — подробности см. в файле LICENSE.

Внося вклад

Вклады приветствуются! Пожалуйста, не стесняйтесь отправлять запрос на включение.

Благодарности

• Модель контекстного протокола для MCP SDK

• Hevy за свою платформу для отслеживания фитнеса и API