SkillFoxx

xbsl-mcp-docs

An MCP server with full-text search over local 1C:Element documentation, including your own markdown and PDF files

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

Extended access

Why this level

  • Runs a local HTTP server that indexes 1C:Element documentation into SQLite
  • The admin API with no auth enabled accepts files and triggers reindexing from any client
All reasons and checks
Russian stack

korolevpavel/xbsl-mcp-docsAuthor:Pavel Korolev

Install

Manual install

docker compose up --build -d

After creating .env with TOPICS_HOST_PATH and STDLIB_HOST_PATH and the data/uploads and data/index folders.

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • Runs a local HTTP server that indexes 1C:Element documentation into SQLite
  • The admin API with no auth enabled accepts files and triggers reindexing from any client

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

What it does

The server indexes pre-prepared topics and stdlib documentation folders for the 1C:Element platform through SQLite FTS5, supports html, markdown and PDF, and can incrementally reindex only changed files. Users can add their own markdown and PDF files, including Cyrillic file names, via the admin API or the built-in browser UI. Search and documents are served to an agent over MCP through a Streamable HTTP endpoint at /mcp, with a separate UI for search and index administration. It runs locally via uv or in Docker, with all source paths set through environment variables.

Who it is for. For developers working with the 1C:Element platform who want an agent to search answers directly in local documentation and their own notes.

Good fit when

  • You have local 1C:Element documentation (topics, stdlib) and need fast full-text search from an agent
  • You need to add your own markdown or PDF notes to a shared searchable index
  • Incremental reindexing without rebuilding the whole index matters to you

Not a fit when

  • You do not have prepared topics and stdlib documentation folders for 1C:Element
  • You need search over standard 1C:Enterprise, not the Element platform

Example request

Find the section on working with catalogs in the 1C:Element documentation and show the main methods

MCP

Transport
http
Authentication
not required

Environment variables

TOPICS_ROOT required
Path to the main 1C:Element documentation folder for a local run.
STDLIB_ROOT required
Path to the standard library reference folder for a local run.
ADMIN_USERNAME
Login for basic auth on admin routes, optional.
ADMIN_PASSWORD secret
Password for basic auth on admin routes, optional.

Limitations

The project does not ship the 1C:Element documentation itself, only indexes already prepared folders whose path must be obtained separately. Basic auth for admin routes is optional and not enabled by default. Reindexing after changing paths in Docker requires manually updating .env and restarting the container.

How to disable. Stop the server with docker compose down or interrupt the uv run xbsl-mcp-docs process, then remove the server from your MCP client config.

FAQ

Can you upload your own files into the index?

Yes, via POST /admin/upload or the built-in admin UI, with markdown and PDF supported, including Cyrillic file names.

Is Docker required?

No, the server can run locally via uv sync and uv run xbsl-mcp-docs given Python 3.12+.

Discussion

No questions or reviews yet.

All 1C:Enterprise tools
Russian stack

An MCP server for Codex with semantic search over 1C's Standard Subsystems Library documentation

MCP serverExtended access3

1C Platform Help MCP Server

Onec Platform Help MCP Server

Russian stack

An MCP and REST server with hybrid search (BM25 plus semantic) over the official 1C:Enterprise platform help

MCP serverExtended access22
Russian stack

An MCP server for searching the 1C platform syntax reference: global functions, object methods and properties via Elasticsearch

MCP serverExtended access76
Russian stack

An MCP server for the 1C platform API docs read straight from shcntx_ru.hbk help files, with keyword, semantic and hybrid search

MCP serverExtended access18

1C OData MCP with a JSON cache

MCP сервер для работы с OData 1C

Russian stack

A Python MCP server over 1C OData: reads and changes catalogs and documents, saving everything to JSON files for local analysis without repeat queries

MCP serverBroad access4

README in short

The README lists capabilities (FTS5 search, html/md/pdf indexing, incremental reindexing, built-in UI), describes three data sources (topics, stdlib, uploads), gives step-by-step setup via Docker Compose and locally via uv, the list of environment variables, a route map for MCP, UI and the admin API, curl examples for reindexing and uploading a file, and development commands (ruff, pytest).

README badge

Report a problem