opengym-mcp

MCP-сервер для работы с базой упражнений OpenGym. ИИ может искать упражнения, получать детали по ID и составлять тренировочные планы.

Что внутри

Tools

Tool	Описание
search_exercises(query, lang)	Поиск по ключевому слову (название, категория, мышцы, часть тела)
get_exercise(exercise_id, lang)	Полная информация об упражнении по ID
get_all_exercises(lang)	Список всех упражнений (для составления плана)

Resources

Resource	Описание
resource://plan-example	Шаблон плана тренировок на неделю

Языки: ru, en, es, fr, de, it, tr, zh, hi, ko, pl

---

Установка

# 1. Клонируем репо
git clone <repo-url> && cd opengym-mcp

# 2. Создаём venv и ставим зависимости
uv venv
uv pip install -r requirements.txt

# Или через pip:
# python3 -m venv .venv
# .venv/bin/pip install -r requirements.txt

Проверка:

.venv/bin/python main.py
# Сервер запускается на stdio — готов к подключению

---

Настройка редакторов

Zed

Открой ~/.config/zed/settings.json → секция context_servers:

{
  "context_servers": {
    "opengym-mcp": {
      "settings": {},
      "command": "python3",
      "args": ["<path-to>/opengym-mcp/main.py"]
    }
  }
}

Или укажи полный путь к питону из venv: "<path-to>/opengym-mcp/.venv/bin/python"

Убедись, что в профиле агента включены context servers:

{
  "agent": {
    "profiles": {
      "default": {
        "enable_all_context_servers": true
      }
    }
  }
}

После перезагрузки Zed: cmd-shift-p → assistant: open → в настройках агента должен появиться opengym-mcp.

---

VS Code (Copilot / Cline / Continue)

Вариант A — .vscode/mcp.json (рекомендуется)

Создай файл .vscode/mcp.json в корне проекта:

{
  "servers": {
    "opengym-mcp": {
      "type": "stdio",
      "command": "<path-to>/opengym-mcp/.venv/bin/python",
      "args": ["<path-to>/opengym-mcp/main.py"]
    }
  }
}

Вариант B — settings.json

В User Settings (cmd+, → Open Settings JSON):

{
  "mcp": {
    "servers": {
      "opengym-mcp": {
        "type": "stdio",
        "command": "<path-to>/opengym-mcp/.venv/bin/python",
        "args": ["<path-to>/opengym-mcp/main.py"]
      }
    }
  }
}

После сохранения — в Copilot Chat / Cline появятся tools search_exercises, get_exercise, get_all_exercises и resource plan-example.

---

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

opengym-mcp/
├── main.py              # MCP-сервер
├── sqlite.db            # БД с 1324 упражнениями
├── plan.example.json    # Шаблон плана (resource)
├── requirements.txt     # Зависимости
└── .gitignore