1C Syntax Helper MCP Server
A shared Elasticsearch-backed MCP server for searching 1C syntax help from VS Code: functions, object methods, properties, code examples
Low risk
We rate an entry low when it mostly gives the agent instructions and reference material.
Why this level
- Only reads and searches platform documentation; it has no access to any infobase
Install
Manual install
docker compose up -dBrings up Elasticsearch and the FastAPI MCP server; the .hbk file must be placed in data/hbk first.
This is third-party code. Review the repository files before installing.
What it does
The server parses a 1C platform documentation .hbk file, indexes it in Elasticsearch, and exposes search tools over MCP: a universal find_1c_help search, full and quick reference for an element, context-filtered search, a list of an object's methods, properties and events, and code usage examples. It is designed as a shared service on one machine in a local network: one Elasticsearch instance and one documentation .hbk file serve up to eight concurrent VS Code users with no individual authentication.
Who it is for. For 1C developer teams who want one shared fast-search service over the platform's syntax helper instead of local docs for each developer.
Good fit when
- You need fast lookup of global functions and object methods from VS Code
- You want one shared reference service for the team instead of a local install for each developer
Not a fit when
- You need authentication or access control: the server runs without it over the local network
- You need automatic documentation refresh: the .hbk update is a manual, once-a-year process
Example request
Find all methods and properties of the ТаблицаЗначений object and show a usage example of ДобавитьLimitations
Documentation is refreshed manually about once a year by swapping the .hbk file and reindexing. The service does not authenticate users and assumes a trusted local network. The project carries a lot of internal refactoring report files, a sign the code is not yet fully settled.
How to disable. Stop the containers with docker compose down and remove the server entry from VS Code's settings.json.
MCP
- Transport
- http
- Authentication
- not required
Security check
- Only reads and searches platform documentation; it has no access to any infobase
README in short
The README credits an Infostart article as the original idea, describes an architecture with a shared Elasticsearch instance and a FastAPI MCP server on localhost:8002, a table of nine MCP tools, a yearly .hbk update cycle, and a recipe for sending Cyrillic text through a file instead of a CLI argument due to Windows encoding issues.
FAQ
Is authentication required to connect?
No, the service is designed as a shared local server with no individual authentication.
How often is the reference data refreshed?
Documentation is updated manually about once a year by replacing the .hbk file and reindexing via /index/rebuild.
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