InstantCMS MCP Server
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@InstantCMS MCP Serverscaffold a basic addon with an admin panel and a widget"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
InstantCMS MCP Server
MCP (Model Context Protocol) сервер для разработки дополнений и шаблонов на базе InstantCMS 2.
Подключив этот сервер к AI-ассистенту (Claude, Cursor и др.), вы получаете полный контекст системы — хуки, API классов, структуры файлов — и можете создавать рабочие дополнения с первого запроса.
Возможности
102 хука с описанием параметров, типов и готовыми примерами реализации
Генерация скаффолда — все файлы дополнения за один вызов (manifest, install, model, frontend, actions, backend, widgets, routes)
API классов — cmsModel, cmsTemplate, cmsRequest, cmsCache, cmsEventsManager и другие
Валидация — проверка структуры дополнения на корректность
Поиск хуков — по имени, описанию, категории, параметрам
Примеры кода — паттерны для типовых задач (пагинация, AJAX, кэш, формы)
Установка
Требования
Node.js 18+
npm
Клонирование и сборка
git clone https://github.com/your-username/instantcms-mcp.git
cd instantcms-mcp
npm install
npm run buildПодключение к Claude Desktop
Добавьте в ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) или %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"instantcms": {
"command": "node",
"args": ["/absolute/path/to/instantcms-mcp/dist/index.js"]
}
}
}Перезапустите Claude Desktop. В чате появятся инструменты с префиксом instantcms.
Подключение к Cursor / другим MCP-клиентам
{
"mcp": {
"servers": {
"instantcms": {
"command": "node",
"args": ["/absolute/path/to/instantcms-mcp/dist/index.js"]
}
}
}
}Запуск инспектора (отладка)
npm run inspectorИнструменты
Tool | Описание |
| Структура файлов дополнения (5 типов) |
| Генерация готового кода всех файлов |
| Список хуков с фильтрацией по категории/типу |
| Детали хука + пример реализации |
| Полнотекстовый поиск хуков |
| API класса (cmsModel, cmsTemplate и др.) |
| Список всех компонентов |
| Валидация структуры дополнения |
| Типы полей форм (14 типов) |
| Примеры кода для типовых задач |
| Генерация шаблона темы |
| Структура и переменные шаблона |
Примеры использования
Создать дополнение с нуля
Создай дополнение для отображения каталога товаров с категориями,
админ-панелью для управления, виджетом последних добавлений
и интеграцией с поиском сайтаНайти нужный хук
Какой хук использовать, чтобы добавить вкладку на страницу профиля пользователя?Реализовать хук
Напиши реализацию хука content_after_add_approve, который добавляет
уведомление в нашу кастомную систему нотификацийРазобраться с API
Как правильно использовать cmsModel для постраничного вывода
с несколькими JOIN и сортировкой?Структура проекта
src/
├── data/
│ ├── hooks.ts # 102 хука по 17 категориям
│ ├── components.ts # API базовых классов
│ └── schemas.ts # Структуры дополнений, типы полей
├── tools/
│ ├── hooks-tool.ts # list / get / search хуков
│ ├── addon-tool.ts # структура, API, валидация, примеры
│ └── scaffold-tool.ts # генерация файлов дополнений
├── server.ts # Регистрация tools и resources
└── index.ts # Точка входа (stdio transport)Структура генерируемого пакета
scaffold_addon создаёт пакет в формате менеджера расширений InstantCMS:
[pkg] manifest.ru.ini ← метаданные пакета
[pkg] install.sql ← SQL для создания таблиц
package/
system/
controllers/{name}/
frontend.php ← class {name} extends cmsFrontend
backend.php ← class backend{Name} extends cmsBackend
model.php ← class model{Name} extends cmsModel
actions/
index.php ← class action{Name}Index extends cmsAction
view.php ← class action{Name}View extends cmsAction
hooks/
{hook_name}.php ← class on{Name}{Hook} extends cmsAction
backend/
forms/form_item.php
forms/form_options.php
grids/grid_items.php
widgets/list/
widget.php
options.form.php
languages/ru/controllers/{name}/{name}.phpУстановка: упаковать в ZIP и загрузить через «Панель управления → Расширения».
Типы дополнений
Тип | Описание |
| Только фронтенд (список + просмотр) |
| Фронтенд + CRUD в административной панели |
| Интеграция с другими компонентами через хуки |
| Кастомные URL-маршруты |
| Виджет для размещения на страницах |
Категории хуков
Категория | Кол-во | Описание |
| 24 | Материалы, типы контента, альбомы, фото |
| 22 | Регистрация, профили, дружба, стена, сообщения |
| 8 | Группы сообщества |
| 9 | Комментарии |
| 5 | Административная панель |
| 6 | Рендер страниц, меню, виджеты |
| 4 | Лента активности |
| 8 | Системные события, email, настройки |
| 3 | Формы |
| 1 | Полнотекстовый поиск |
| 2 | XML-карта сайта |
| 1 | RSS-ленты |
| 3 | Планировщик задач |
| 3 | Подписки |
| 2 | Рейтинг и голосование |
| 1 | Очередь модерации |
| 2 | Настройки контроллеров |
Разработка
# Режим наблюдения (hot reload)
npm run dev
# Пересборка
npm run build
# Запуск инспектора MCP
npm run inspectorСовместимость
InstantCMS: 2.x (протестировано на 2.18.1)
Node.js: 18+
MCP SDK: @modelcontextprotocol/sdk ^1.0
Лицензия
MIT
This server cannot be installed
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/maxisoft-git/instantcms-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server