Индексатор кода Bitrix Framework
Bitrix MCP
Локальный MCP-индексатор проекта на 1С-Битрикс без токена: символы, события, ORM, граф зависимостей и опциональный доступ к БД
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Опциональный bitrix_tinker выполняет произвольный PHP-код с записью на локальной машине
- Опциональный доступ к БД при включенном флаге записи меняет данные проекта напрямую в MySQL
Установка
Ручная установка
npm install -g @mb4it/bitrix-mcpИли без установки: npx @mb4it/bitrix-mcp init.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер индексирует локальный проект на Bitrix Framework или 1С-Битрикс: свой код, шаблоны и компоненты, ядро Битрикса (если есть папка bitrix/) и официальную документацию через полнотекстовый поиск SQLite, с опциональным семантическим поиском через Python-сервис. Дает агенту поиск функций, классов, методов, событий, компонентов и констант по всему проекту и ядру, отдельные инструменты для ORM-сущностей, инфоблоков, highload-блоков, опций и агентов, граф зависимостей с обходом соседей и радиусом влияния изменения. Не требует ни модуля в Битрикс, ни токена: доступ определяется только тем, какие локальные папки открыты. Отдельно, полностью по желанию пользователя, включаются два мощных режима: прямой доступ к MySQL проекта (учетные данные берутся из bitrix/.settings.php, чтение по умолчанию, запись отдельным флагом) и bitrix_tinker: выполнение произвольного PHP с полностью загруженным ядром Битрикса, аналог Laravel Tinker с полным выполнением кода и записью на локальной машине.
Для кого. Для разработчиков крупных проектов на Bitrix Framework, которым нужен точный поиск по коду и ядру вместо grep и угадывания сигнатур методов.
Подходит, если
- Нужен точный поиск обработчиков события, ORM-сущностей или использования модуля по всему проекту и ядру
- Нужно оценить радиус влияния изменения перед рефакторингом
- Нужен локальный, приватный индекс без установки модуля в Битрикс и без токена
Не подходит, если
- Нужен доступ к живым данным CRM или каталога через REST, а не к коду проекта
- Нет доверенной локальной среды разработки: DB-доступ и bitrix_tinker дают полный доступ к базе и выполнение кода
Пример запроса к агенту
Проверь статус индекса, затем найди, как в этом проекте зарегистрированы обработчики событий модуля saleОграничения
Требует Node.js 22.12+ (использует node:sqlite) и npm 10+, для семантического поиска дополнительно Python 3.11+. Первая индексация документации клонирует официальный репозиторий документации Битрикс и требует сети, это можно отключить переменной окружения. Доступ к базе и bitrix_tinker выключены по умолчанию и должны включаться осознанно только в доверенном локальном окружении, никогда на общих или боевых машинах.
Как отключить. Удалите пакет командой npm uninstall -g @mb4it/bitrix-mcp и запись сервера из конфигурации MCP-клиента, при необходимости сотрите папку .bitrix-mcp с индексами.
MCP
- Транспорт
- stdio
- Авторизация
- не нужна
| Переменные окружения | |
|---|---|
| BITRIX_ROOT | Корень проекта Битрикс для индексации ядра |
| BITRIX_MCP_DB_ENABLED | Включает опциональные инструменты доступа к MySQL проекта, по умолчанию выключено |
| BITRIX_MCP_TINKER_ENABLED | Включает bitrix_tinker с полным выполнением PHP-кода, по умолчанию выключено |
Проверка безопасности
- Опциональный bitrix_tinker выполняет произвольный PHP-код с записью на локальной машине
- Опциональный доступ к БД при включенном флаге записи меняет данные проекта напрямую в MySQL
Коротко о README
README перечисляет возможности (поиск символов и LiveAPI, индексация проекта, шаблонов и ядра, поиск по документации, граф зависимостей и радиус влияния), требования и установку через npm или npx, быстрый старт командой init с выбором агента, повседневные CLI-команды индексации, список MCP-инструментов по группам, переменные окружения, отдельные разделы про опциональный доступ к базе данных и про bitrix_tinker с явным предупреждением о полном выполнении кода, и ссылки на подробную документацию по каждой теме. Лицензия MIT.
Частые вопросы
Нужен ли токен или модуль в Битрикс?
Нет, сервер полностью локальный и работает с файлами проекта напрямую, доступ определяется только открытыми папками.
Насколько опасен bitrix_tinker?
Это полноценное выполнение PHP-кода с полностью загруженным ядром Битрикса и правом записи, README прямо предупреждает включать его только в доверенной локальной среде разработки и никогда на боевых машинах.
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything