mcp-super-app

MCP-сервер для Claude Code: собирает рутинные setup-действия (каркас проекта, скиллы, среда сборки лендинга, guard-хук, картинки, иконки) в одну точку входа. Подключил сервер → все инструменты доступны из любого чата обычными tool-вызовами.

Стек: TypeScript + @modelcontextprotocol/sdk, транспорт stdio (локальный сервер, никуда ничего не отправляет, кроме OpenRouter при генерации картинок).

---

Установка — одной фразой

Открой Claude Code и отправь ему это сообщение:

Установи MCP-сервер по инструкции: https://github.com/AndreyTsibin/mcp-super-app-public/blob/main/INSTALL.md

Дальше агент всё сделает сам: проверит окружение, склонирует репозиторий, соберёт и подключит сервер. Разбираться в коде не нужно.

Полная пошаговая инструкция (в том числе что делать, если что-то пошло не так) — в INSTALL.md.

---

Требования

• Node.js ≥ 20.
• Ключ OpenRouter — только для create_image. Остальные инструменты работают без ключа. Ключ у каждого свой: https://openrouter.ai/keys.
• Для install_guard нужен jq (brew install jq) — иначе guard-скрипт fail-open'ит (пропускает всё).

Инструменты

Инструмент	Что делает
bootstrap_project	Разворачивает каркас нового проекта одним вызовом: .gitignore, .editorconfig, .claude/ (settings, хук, CLAUDE.md, HANDOFF), docs/ по профилю S/M/L и Auto-memory. Идемпотентно — существующее не затирает.
install_skill	Ставит скилл в проект: bundled → копия в .claude/skills/<id>/; proxied → прогон официального CLI. Артефакты авто-добавляются в .gitignore. Каталог доступных скиллов (тип, назначение, команда установки для proxied) лежит прямо в описании параметра skill.
create_website	Единая точка входа для сайтов, режим выбирается параметром kind. landing — Astro-проект генератора: библиотека из 21 секции с вариантами, токен-контракт + тема, страницы /kit (полигон) и /themes (выбор темы), каркасы страниц с маркерами [[…]] вместо текста, стандарты docs/, шаблоны заявок send.php + lead-form.js, previewer и машинный валидатор .claude/check-landing.mjs. multipage — переделка существующего сайта (донора) в свой: playbook метода (разведка донора, единственные источники правды, токены, редизайн-дельта против фильтров за дубли, роутинг, приёмка) + обкатанный код заявок; шаблон и каркас не разворачиваются намеренно — стек и структура зависят от донора. Оба режима ставят скиллы флоу, пишут docs/_dev/tracker.md (одна строка = одна сессия) и дописывают протокол «одна сессия = одна задача» в .claude/CLAUDE.md проекта.
install_guard	Ставит PreToolUse-хук защиты от деструктивных команд (rm, find -delete, git reset --hard и т.п.) — глобально (target=user) или в проект. Безопасный merge в settings.json.
create_image	Единая точка входа для картинок: генерация и редактирование через OpenRouter. Возвращает картинку в чат + сохраняет файл в проект (./generated по умолчанию) + отдаёт usage.cost. Дефолт-модель — Seedream 4.5 (bytedance-seed/seedream-4.5, $0.04 за кадр при любом размере), Gemini 3 Flash/Pro — через model. reference_images (пути/URL) — image-to-image, редактирование и консистентность серии. Промпт обязателен через скилл image: нет скилла в проекте или пустой prompt_source — тул отказывает и не тратит деньги.
optimize_images	Готовит картинки к продакшену (sharp): ресайз до max_width (без апскейла), конверт в webp/jpeg/avif, EXIF-поворот, опциональные srcset-варианты (widths). По умолчанию заменяет исходник оптимизированным файлом. Возвращает итоговые размеры (для width/height в <img>).
search_icons	Ищет иконку по английскому слову/концепту в двух наборах: lucide (~2000 generic UI-иконок — wrench, shield, clock…) и simple-icons (~3400 лого брендов — GitHub, HP, Telegram…). Возвращает точные name/set для get_icon.
get_icon	Отдаёт сырой SVG иконки по точному name/set. size — px (квадрат), color — CSS-цвет (lucide и так currentColor; simple-icons по умолчанию — официальный фирменный hex бренда).

Ключ OpenRouter

Нужен, только если будешь генерировать картинки.

cp .env.example .env
# впиши свой ключ: OPENROUTER_API_KEY=sk-or-v1-...

.env игнорируется git (см. .gitignore). Ключ берётся из .env в корне пакета — сервер грузит его сам при старте, передавать через конфиг не нужно.

Подключение к Claude Code вручную

Если по какой-то причине не сработал автоматический путь из INSTALL.md.

1. CLI (глобально, для всех проектов — -s user):

claude mcp add mcp-super-app -s user -- node /абсолютный/путь/к/mcp-super-app/dist/index.js

2. Файл .mcp.json (в корне проекта — для этого проекта, или в ~/.claude.json — глобально):

{
  "mcpServers": {
    "mcp-super-app": {
      "command": "node",
      "args": ["/абсолютный/путь/к/mcp-super-app/dist/index.js"]
    }
  }
}

Путь обязательно абсолютный — ~ и относительные не разворачиваются, конфиг глобальный. На Windows это C:\\Users\\Имя\\mcp-super-app\\dist\\index.js (в JSON обратные слэши экранируются, как здесь).

Автообновления нет. Обновление ручное: git pull && npm install && npm run build в папке репозитория, потом перезапуск Claude Code. Раньше этим занимался bash-скрипт launch.sh, но на Windows он не запускался, и держать разное поведение на разных ОС оказалось дороже, чем обновляться руками.

После подключения перезапусти Claude Code.

Разработка

npm install
npm run build      # компиляция TS → dist/
npm run dev        # tsx watch — запуск из src/ без сборки
npm run typecheck  # tsc --noEmit
npx @modelcontextprotocol/inspector node dist/index.js   # ручная проверка тулов

Точка запуска сервера — dist/index.js (stdio).

Структура

src/
├── index.ts          # точка входа: регистрация tools + stdio transport, загрузка .env
├── lib/              # общая инфра: openrouter, scaffold, project-slug, errors, settings-merge, …
└── tools/            # по модулю на инструмент
assets/               # статические шаблоны: skills/, bootstrap/, landing/, guard/
docs/                 # спеки и стандарты (архитектура, API)

Договорённости и рабочий метод — в .claude/CLAUDE.md.