BSL Atlas
A Dockerized MCP server for searching 1C dumps: structural index, call graph and semantic code search
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 -dSet 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 fromLimitations
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 | |
|---|---|
| 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.
Related
A skills library that gives coding agents a development process: brainstorming, planning, TDD, subagents and code review
Skills for real engineers by Matt Pocock
Skills For Real Engineers
Small composable skills for engineering with agents: plan grilling, TDD, bug diagnosis, code review and architecture
GitHub toolkit for spec-driven development: the specify CLI adds agent commands and skills to a project, from principles to implementation
Reference MCP servers
Model Context Protocol servers
Official reference MCP servers: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time and Everything