PHPackages                             warenikov/mcp-bitrix - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Database & ORM](/categories/database)
4. /
5. warenikov/mcp-bitrix

ActiveLibrary[Database & ORM](/categories/database)

warenikov/mcp-bitrix
====================

MCP server for Bitrix CMS — manage iblocks, highload, users, ORM via Claude

v0.2.3(1mo ago)04↑2900%MITPHPPHP ^8.1CI passing

Since Mar 27Pushed 1mo agoCompare

[ Source](https://github.com/warenikov/mcp-bitrix)[ Packagist](https://packagist.org/packages/warenikov/mcp-bitrix)[ RSS](/packages/warenikov-mcp-bitrix/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (1)Versions (11)Used By (0)

mcp-bitrix
==========

[](#mcp-bitrix)

[![Tests](https://github.com/warenikov/mcp-bitrix/actions/workflows/tests.yml/badge.svg)](https://github.com/warenikov/mcp-bitrix/actions/workflows/tests.yml)[![Docker](https://github.com/warenikov/mcp-bitrix/actions/workflows/docker.yml/badge.svg)](https://github.com/warenikov/mcp-bitrix/actions/workflows/docker.yml)

MCP-сервер для управления Битриксом через Claude. Позволяет создавать инфоблоки, управлять элементами, работать с пользователями и многое другое — прямо из чата.

Требования
----------

[](#требования)

- Битрикс CMS (любая версия с поддержкой D7)
- Docker
- [Claude Code](https://claude.ai/code)

PHP на хосте **не нужен** — сервер запускается в собственном Docker-контейнере.

Установка
---------

[](#установка)

### Быстрый старт — скрипт установки

[](#быстрый-старт--скрипт-установки)

Запустите в корне вашего Битрикс-проекта:

```
curl -sL https://raw.githubusercontent.com/warenikov/mcp-bitrix/main/install.sh | bash
```

Скрипт автоматически:

- скачает Docker-образ `ghcr.io/warenikov/mcp-bitrix`
- определит Docker-сеть проекта
- создаст `.mcp.json` и `.claude/settings.json` в текущей папке

После этого **перезапустите Claude Code** — сервер подключится автоматически.

---

### Ручная установка

[](#ручная-установка)

Создайте `.mcp.json` в корне проекта:

```
{
  "mcpServers": {
    "bitrix": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "-v", "/путь/к/проекту:/var/www/html", "ghcr.io/warenikov/mcp-bitrix:latest"]
    }
  }
}
```

Замените `/путь/к/проекту` на абсолютный путь к папке с вашим Битриксом (где лежит `bitrix/`).

Если Битрикс работает в Docker — добавьте `--network` с именем сети вашего проекта:

```
"args": ["run", "--rm", "-i", "--network", "myproject_default", "-v", "/путь/к/проекту:/var/www/html", "ghcr.io/warenikov/mcp-bitrix:latest"]
```

Создайте `.claude/settings.json`:

```
{
  "enabledMcpjsonServers": ["bitrix"]
}
```

Перезапустите Claude Code.

---

Настройка
---------

[](#настройка)

### Режим только чтения

[](#режим-только-чтения)

Чтобы запретить любые изменения данных, добавьте в `.mcp.json`:

```
{
  "mcpServers": {
    "bitrix": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "-v", "/путь/к/проекту:/var/www/html", "ghcr.io/warenikov/mcp-bitrix:latest"],
      "env": {
        "BITRIX_READONLY": "true"
      }
    }
  }
}
```

В этом режиме все операции создания, обновления и удаления заблокированы.

### Нестандартный путь к сайту внутри контейнера

[](#нестандартный-путь-к-сайту-внутри-контейнера)

Если Битрикс смонтирован не в `/var/www/html`:

```
"args": ["run", "--rm", "-i", "-e", "BITRIX_DOCUMENT_ROOT=/var/www/mysite", "-v", "/путь/к/проекту:/var/www/mysite", "ghcr.io/warenikov/mcp-bitrix:latest"]
```

---

Реализованные инструменты
-------------------------

[](#реализованные-инструменты)

### Типы инфоблоков

[](#типы-инфоблоков)

ИнструментОписание`list_iblock_types`Список всех типов`create_iblock_type`Создать тип`delete_iblock_type`Удалить тип### Инфоблоки

[](#инфоблоки)

ИнструментОписание`list_iblocks`Список (фильтр по типу)`get_iblock`Получить по ID`create_iblock`Создать`update_iblock`Обновить`delete_iblock`Удалить### Свойства

[](#свойства)

ИнструментОписание`list_iblock_properties`Список свойств`add_iblock_property`Добавить (типы: S/N/L/F/G/E)`update_iblock_property`Обновить`delete_iblock_property`Удалить### Секции

[](#секции)

ИнструментОписание`list_iblock_sections`Список секций`add_iblock_section`Добавить`update_iblock_section`Обновить`delete_iblock_section`Удалить### Элементы

[](#элементы)

ИнструментОписание`get_iblock_elements`Выборка с фильтром и постраничкой`get_iblock_element`Получить по ID (со свойствами)`add_iblock_element`Добавить`update_iblock_element`Обновить (поля + свойства)`delete_iblock_element`Удалить---

В разработке
------------

[](#в-разработке)

### Ближайшие (Фаза 1)

[](#ближайшие-фаза-1)

- **Highload-блоки** — CRUD для HL-блоков, полей и элементов
- **Пользователи** — создание, группы, пользовательские поля
- **ORM** — генерация DataManager-классов, создание таблиц

### Планируется

[](#планируется)

- **Каталог и магазин** — товары, цены, заказы
- **CRM** — лиды, сделки, контакты
- **Задачи и бизнес-процессы**
- **Системные инструменты** — агенты, события, настройки модулей

---

Обновление
----------

[](#обновление)

Чтобы обновить сервер до последней версии:

```
docker pull ghcr.io/warenikov/mcp-bitrix:latest
```

Перезапускать Claude Code после этого не нужно — образ подтянется при следующем вызове инструмента.

---

Как это работает
----------------

[](#как-это-работает)

```
Claude → MCP protocol (stdio) → docker run --rm -i -v /project:/var/www/html ghcr.io/warenikov/mcp-bitrix → Bitrix PHP API → JSON

```

При каждом вызове инструмента Claude запускает одноразовый Docker-контейнер, который монтирует папку вашего проекта и напрямую обращается к ядру Битрикса. Никаких внешних зависимостей — MCP-протокол реализован без сторонних библиотек.

Лицензия
--------

[](#лицензия)

MIT

###  Health Score

37

—

LowBetter than 83% of packages

Maintenance90

Actively maintained with recent releases

Popularity5

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity39

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

9

Last Release

46d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/10303877?v=4)[warenikov](/maintainers/warenikov)[@warenikov](https://github.com/warenikov)

---

Top Contributors

[![warenikov](https://avatars.githubusercontent.com/u/10303877?v=4)](https://github.com/warenikov "warenikov (17 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/warenikov-mcp-bitrix/health.svg)

```
[![Health](https://phpackages.com/badges/warenikov-mcp-bitrix/health.svg)](https://phpackages.com/packages/warenikov-mcp-bitrix)
```

###  Alternatives

[doctrine/orm

Object-Relational-Mapper for PHP

10.2k285.3M6.2k](/packages/doctrine-orm)[jdorn/sql-formatter

a PHP SQL highlighting library

3.9k115.1M102](/packages/jdorn-sql-formatter)[illuminate/database

The Illuminate Database package.

2.8k52.4M9.4k](/packages/illuminate-database)[mongodb/mongodb

MongoDB driver library

1.6k64.0M546](/packages/mongodb-mongodb)[ramsey/uuid-doctrine

Use ramsey/uuid as a Doctrine field type.

90340.3M211](/packages/ramsey-uuid-doctrine)[reliese/laravel

Reliese Components for Laravel Framework code generation.

1.7k3.4M16](/packages/reliese-laravel)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)