SkillFoxx

Bitrix Framework code indexer MCP

Bitrix MCP

A local, token-free MCP indexer for 1C-Bitrix projects: symbols, events, ORM, a dependency graph and optional DB access

  • 2 ★ on the repository
  • Last commit
  • MIT
MCP server

Broad access

Why this level

  • The optional bitrix_tinker tool executes arbitrary PHP code with write access on the local machine
  • Optional DB access, with the write flag enabled, changes project data directly in MySQL
All reasons and checks
Russian stack

dictator90/bitrix-mcpAuthor:Dictator90

Install

Services

Manual install

npm install -g @mb4it/bitrix-mcp

Or without installing: npx @mb4it/bitrix-mcp init.

Access and checks

How we review

Broad accessThe tool can change data, run commands or handle secrets.

  • The optional bitrix_tinker tool executes arbitrary PHP code with write access on the local machine
  • Optional DB access, with the write flag enabled, changes project data directly in MySQL

This is third-party code. Review the repository files before installing.

What it does

The server indexes a local Bitrix Framework or 1C-Bitrix project: your own code, templates and components, the Bitrix core (if a bitrix/ folder exists), and the official docs via SQLite full-text search, with optional semantic search through a Python service. It gives an agent search over functions, classes, methods, events, components and constants across the project and core, dedicated tools for ORM entities, iblocks, highload blocks, options and agents, and a dependency graph with neighbor traversal and change-impact radius. It needs neither a Bitrix module nor a token: access is limited only to whichever local folders are exposed. Separately, entirely opt-in, two powerful modes can be enabled: direct MySQL access to the project (credentials parsed from bitrix/.settings.php, read-only by default, writes behind a separate flag) and bitrix_tinker, which executes arbitrary PHP with the full Bitrix kernel loaded, a Laravel Tinker analog with full code execution and write access on the local machine.

Who it is for. For developers on large Bitrix Framework projects who need precise code and core search instead of grep and guessing method signatures.

Good fit when

  • You need precise search for event handlers, ORM entities or module usage across the project and core
  • You need to assess the impact radius of a change before refactoring
  • You need a local, private index with no Bitrix module install and no token

Not a fit when

  • You need live CRM or catalog REST data, not project code
  • You have no trusted local dev environment: DB access and bitrix_tinker give full database access and code execution

Example request

Check the index status, then find how this project registers sale module event handlers

MCP

Transport
stdio
Authentication
not required

Environment variables

BITRIX_ROOT
The Bitrix project root for core indexing
BITRIX_MCP_DB_ENABLED
Enables optional MySQL access tools for the project, off by default
BITRIX_MCP_TINKER_ENABLED
Enables bitrix_tinker with full PHP code execution, off by default

Limitations

Requires Node.js 22.12+ (uses node:sqlite) and npm 10+, plus Python 3.11+ for optional semantic search. The first docs index clones the official Bitrix documentation repo and needs network access, which can be disabled via an environment variable. Database access and bitrix_tinker are off by default and must be deliberately enabled only in a trusted local environment, never on shared or production machines.

How to disable. Remove the package with npm uninstall -g @mb4it/bitrix-mcp and the server entry from your MCP client config; delete the .bitrix-mcp index folder if needed.

FAQ

Does it need a token or a Bitrix module?

No, the server is entirely local and works with the project's files directly, access is limited only to the folders it is exposed to.

How risky is bitrix_tinker?

It is full PHP code execution with the whole Bitrix kernel loaded and write access, and the README explicitly warns to enable it only in a trusted local dev environment, never on production machines.

Discussion

No questions or reviews yet.

All 1C-Bitrix tools
Russian stack

A reference to your own 1C-Bitrix API for an agent: a core index with module versions so it stops mixing methods from different versions

MCP serverExtended access1
Russian stack

A 1C-Bitrix module with an MCP server: the agent inspects the site environment, searches core functions, and can run PHP, shell and SQL on the server

MCP serverBroad access26

Read-only MCP server for 1C-Bitrix

MCP-сервер для 1С-Битрикс (только чтение)

Russian stack

A 1C-Bitrix module with 35 read-only MCP tools: catalog, orders, reports, code files and SQL, with per-group access rights

MCP serverExtended access1
Russian stack

A set of rules, skills, linters and an MCP profile for AI development on 1C-Bitrix, with one core shared across Claude Code, Codex and Gemini CLI

PluginExtended access3
Russian stack

A 1C-Bitrix CMS module that turns the website itself into an MCP server exposing infoblocks and the user profile via tokens

MCP serverExtended access2

README in short

The README lists the capabilities (symbol and LiveAPI search, project, template and core indexing, docs search, a dependency graph and impact radius), requirements and install via npm or npx, a quick start with the init command and agent selection, everyday CLI indexing commands, a grouped list of MCP tools, environment variables, separate sections on optional database access and bitrix_tinker with an explicit full-code-execution warning, and links to detailed per-topic docs. MIT license.

README badge

Report a problem