Руководство по установке

Это руководство поможет вам установить и настроить инструмент каркаса gm-mcp.

Системные требования

• Node.js >= 16.0.0
• npm >= 7.0.0 или yarn >= 1.22.0

Методы установки

Метод 1: Глобальная установка (Рекомендуется)

npm install -g @studiogm/gm-mcp

Это самый простой метод. После установки вы можете использовать команду gm-mcp в любом месте.

Метод 2: Использование npx (Установка не требуется)

npx gm-mcp init my-project

Автоматически загружает последнюю версию каждый раз при использовании, подходит для периодического использования.

Метод 3: Установка из исходного кода

# Клонировать репозиторий
git clone https://github.com/studiogmls/gm-mcp.git
cd gm-mcp

# Установить зависимости
npm install

# Собрать проект
npm run build

# Глобальная ссылка
npm link

Проверка установки

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

gm-mcp --version

Если отображается номер версии, установка прошла успешно.

Просмотр справки

gm-mcp --help

Это отобразит все доступные команды и опции.

Обновления

Проверка обновлений

gm-mcp update

Ручное обновление

npm update -g @studiogm/gm-mcp

Удаление

Если вам нужно удалить gm-mcp:

npm uninstall -g @studiogm/gm-mcp

Устранение неполадок

Проблемы с разрешениями

Если вы столкнулись с ошибками разрешений, попробуйте:

# Использовать sudo (macOS/Linux)
sudo npm install -g @studiogm/gm-mcp

# Или настроить npm для использования другого каталога
npm config set prefix ~/.npm-global
export PATH=~/.npm-global/bin:$PATH

Проблемы с сетью

Если скорость загрузки медленная, настройте зеркало npm:

npm config set registry https://registry.npmmirror.com

Конфликты версий

Если вы столкнулись с конфликтами версий:

# Просмотр установленной версии
npm list -g @studiogm/gm-mcp

# Принудительная переустановка
npm uninstall -g @studiogm/gm-mcp
npm install -g @studiogm/gm-mcp

Следующие шаги

После установки вы можете:

• Быстрый старт - Создать ваш первый проект
• Базовое использование - Изучить основные команды
• Обзор шаблонов - Узнать о доступных шаблонах