Catalyst MCP
MCP-сервер фреймворка Catalyst: агент получает знания о проекте, разбирает ошибки, сверяет конфиг и ведет план перевода приложения
- 93 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Сервер читает файлы проекта, а токен GitHub открывает создание issue и pull request от вашего имени
- План задач сохраняется в локальной базе проекта
Установка
- Работает в
Ручная установка
npx create-catalyst-app@latestНа вопрос о поддержке MCP отвечают Y; `mcp.js` подключают к клиенту по абсолютному пути.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Сервер читает файлы проекта, а токен GitHub открывает создание issue и pull request от вашего имени
- План задач сохраняется в локальной базе проекта
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Catalyst — React-фреймворк с рендером на сервере для веб-приложений и универсальных приложений под Android и iOS. К нему идет MCP-сервер, который `create-catalyst-app` добавляет в проект файлом `mcp.js`. Сервер читает установленную версию `catalyst-core` и отвечает по ней: для ветки 0.2.x инструкции на webpack, для 0.3.x на Vite и встроенном маршрутизаторе. Инструменты разбирают проект: `debug_issue` и `explain_error` по коду ошибки вроде `PREFLIGHT-001`, `check_config` сверяет конфигурацию платформ, `get_build_flow` и `get_architecture_diagram` показывают сборку и устройство. Для переноса приложения служат `get_conversion_tasks`, `get_conversion_status` и план из шагов (`create_task_plan`, `update_task_step`), хранящийся в базе и переживающий сброс контекста. `query_knowledge` ищет по базе знаний, а `create_github_issue` и `create_github_pr` оформляют обращения.
Для кого. Командам на фреймворке Catalyst, которым нужен агент, знающий версию проекта, его конфигурацию и порядок перевода веб-приложения в универсальное.
Подходит, если
- Сборка падает с кодом `PREFLIGHT-001`, и нужно понять причину
- Веб-приложение на Catalyst переводят в универсальное, и агенту нужен план из шагов с сохранением состояния
- Проект сидит на версии 0.2.x, а часть примеров относится к 0.3.x
- Конфиг Android и iOS надо проверить перед сборкой
Не подходит, если
- Проект не на Catalyst: сервер знает только этот фреймворк
- Нужны инструменты в работающем приложении для браузерных агентов: для этого отдельный WebMCP, а не этот сервер
- Нужен единый общий сервер на несколько проектов: настройку делают отдельно в каждом проекте
Пример запроса к агенту
Объясни ошибку PREFLIGHT-001 в моем проекте Catalyst и покажи, как устроена сборка для Android в режиме debugMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
GITHUB_TOKENсекрет- Токен GitHub для инструментов создания issue и pull request.
Ограничения
Сервер создается при `npx create-catalyst-app@latest` и подключается файлом `mcp.js` проекта по абсолютному пути. В монорепозитории настройку выполняют из пакета приложения, а не из корня. Требуется Node.js 20 или новее, план задач хранится в локальной базе SQLite. Если установленную версию `catalyst-core` определить не удалось, версию перед шагами миграции подтверждают вручную. Для `create_github_issue` и `create_github_pr` нужен токен GitHub, он берется из `GITHUB_TOKEN`, `GITHUB_PAT`, `CATALYST_GITHUB_TOKEN` или сеанса `gh`. Ветка 0.2.x и 0.3.x отличаются по сборке.
Как отключить. Удалите запись `catalyst` из `claude_desktop_config.json` или `.cursor/mcp.json`, при желании удалите и файл `mcp.js` проекта.
Частые вопросы
Как включить MCP в проекте Catalyst?
При создании проекта командой `npx create-catalyst-app@latest` ответьте Y на вопрос о поддержке MCP, и в проекте появится `mcp.js`.
Как подключить к Claude Desktop?
В `claude_desktop_config.json` добавьте `catalyst` с командой `node` и абсолютным путем к `mcp/mcp.js` вашего проекта.
Чем MCP отличается от WebMCP?
Этот сервер работает при разработке в Node и помогает ИИ-инструментам понимать проект. WebMCP открывает инструменты самого запущенного приложения браузерным агентам.
Какие версии фреймворка поддерживаются?
Сервер читает установленную версию и разделяет инструкции для 0.2.x на webpack и 0.3.x на Vite со встроенным маршрутизатором.
Какая лицензия?
MIT.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер CodeRocket отдает агенту правила дизайн-системы, компоненты и блоки сохраненной библиотеки только на чтение.
Агент получает спецификацию MDMA, промпты и проверку, чтобы отвечать формами, таблицами и согласованиями прямо в Markdown
ReactUse MCP — справочник React-хуков
ReactUse MCP
MCP-сервер ReactUse: агент находит нужный React-хук и читает его описание, пример и таблицу API прямо из библиотеки
Vibe MCP отдает агенту компоненты, иконки и токены дизайн-системы monday.com Vibe
UI5 MCP Server помогает агенту создавать приложения SAP UI5, проверять манифест и код линтером и читать актуальный API.
Ignite UI CLI создает проекты на Angular, React и Web Components, а ig ai-config настраивает MCP и навыки.
Коротко о README
README фреймворка описывает Catalyst, быстрый старт командой `create-catalyst-app` и ссылки на документацию. Страница документации по MCP объясняет включение, подключение к Claude Desktop, Cursor и Deputy Dev и правила для монорепозиториев.