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
- 1 ★ on the repository
- Last commit
Extended access
Why this level
- Starts Elasticsearch and an HTTP search server for 1C platform help in Docker
- The service is open on the local network with no user authentication
royfincher25-source/1c-syntax-helper-mcp
A similar tool with a larger community: 1C Syntax Helper MCP Server, 76 ★ on the repository
Install
- Works in
- Services
Manual install
docker compose up -dBrings up Elasticsearch and the FastAPI MCP server; the .hbk file must be placed in data/hbk first.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Starts Elasticsearch and an HTTP search server for 1C platform help in Docker
- The service is open on the local network with no user authentication
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 ДобавитьMCP
- Transport
- http
- Authentication
- not required
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.
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.
Discussion
No questions or reviews yet.
Related
All 1C:Enterprise toolsAn MCP server for searching the 1C platform syntax reference: global functions, object methods and properties via Elasticsearch
1C 8.3 syntax helper MCP
1C Syntax Helper MCP (mcp-1c-helper)
A read-only MCP server searches 1C:Enterprise 8.3 docs in Elasticsearch and returns results via hybrid BM25 plus embedding search
An MCP server for searching and validating 1C syntax that unpacks the reference straight from your installed platform on first run
1C platform reference over MCP
mcp-bsl-platform-context
An MCP server with the 1C syntax assistant reference: search functions, types, methods, properties and constructors from the installed platform
An MCP server and CLI for 1C that build full-text and vector indexes over the platform's .hbk help and parse PascalCase Russian identifiers
An MCP server that unpacks 1C's .hbk help, indexes it in Qdrant and gives the agent search over API, snippets and standards
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.