BSL Atlas

A Dockerized MCP server for searching 1C dumps: structural index, call graph and semantic code search

MCP serverMedium riskRussian stack

arman-kudaibergenov/bsl-atlas

Install

curl -O https://raw.githubusercontent.com/Arman-Kudaibergenov/bsl-atlas/master/docker-compose.yml
curl -O https://raw.githubusercontent.com/Arman-Kudaibergenov/bsl-atlas/master/.env.example
cp .env.example .env
docker compose up -d

Set SOURCE_PATH and INDEXING_MODE in .env before starting.

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

What it does

The server indexes the XML and BSL dump of a configuration or extension into SQLite with full-text search. The agent looks up routines by name, lists module functions with call context, and finds metadata objects and their structure. Fast mode needs no external APIs; full mode adds vector search over code and help through a chosen embeddings provider. After a new dump the index refreshes via a reindex request, and short LLM-generated descriptions can be imported for uncommented functions.

Who it is for. For 1C developers who want dump search running quickly in Docker without external keys.

Good fit when

  • The agent needs to find routines and metadata objects in a dumped configuration
  • You want a mode with no cloud APIs, only the structural index
  • You want meaning-based function search and have an embeddings provider

Not a fit when

  • No Docker, or the source folder cannot be mounted into the container
  • You need a live infobase rather than a file dump

Example request

Use bsl-atlas to find the routine that fills the tabular section and show where it is called from

Limitations

Works only with a file dump, and each new dump needs a reindex. On Windows, Docker Desktop struggles with paths containing spaces or Cyrillic, so the author suggests a symlink. Full mode needs an embeddings provider key such as OpenRouter, or a local Ollama. The repository is AGPL-3.0.

How to disable. Remove the bsl-atlas block from .mcp.json or claude_desktop_config.json and stop the container with docker compose down.

MCP

Transport
http
Authentication
not required
Environment variables
Environment variables
SOURCE_PATH
required
Host folder with the configuration dump
INDEXING_MODE
required
Indexing mode: fast or full

Security check

  • Runs a container that reads every file in the dump
  • In full mode sends code fragments to an embeddings provider

README in short

The README walks through dumping the configuration to files, downloading docker-compose.yml and .env.example, setting the source path and mode, starting the container and connecting MCP over HTTP. It covers Windows mount issues and supported folder layouts separately. It lists the search tools, recommended embedding models and a way to add LLM-generated function descriptions.

FAQ

How does fast mode differ from full?

Fast gives structural search with no external APIs. Full adds semantic search over code and help and needs an embeddings provider.

Atlas says the source folder is empty. What now?

It is almost always a wrong bind mount: check SOURCE_PATH, and on Windows replace a Cyrillic path with a symlink.

Editors’ pick

A skills library that gives coding agents a development process: brainstorming, planning, TDD, subagents and code review

PluginMedium risk286.7K
Editors’ pick

Small composable skills for engineering with agents: plan grilling, TDD, bug diagnosis, code review and architecture

SkillLow risk262.1K
Editors’ pick

GitHub toolkit for spec-driven development: the specify CLI adds agent commands and skills to a project, from principles to implementation

CLIMedium risk136.8K

Reference MCP servers

Model Context Protocol servers

Editors’ pick

Official reference MCP servers: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time and Everything

MCP serverMedium risk90.3K