1C Syntax MCP Server
An MCP server for searching and validating 1C syntax that unpacks the reference straight from your installed platform on first run
- 34 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- Runs a Python server that finds the installed 1C platform and unpacks its help with 7z
- Writes an index of about 24 MB to disk and does not connect to a 1C database
Install
- Works in
- Services
Manual install
python -m venv venv && venv\Scripts\activate && pip install mcpCreate the environment and install the mcp dependency; 7z must also be installed.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Runs a Python server that finds the installed 1C platform and unpacks its help with 7z
- Writes an index of about 24 MB to disk and does not connect to a 1C database
This is third-party code. Review the repository files before installing.
What it does
On first run the server locates the installed 1C 8.3.x or 8.5.x version, extracts the shcntx_ru.hbk reference file, unpacks it with 7z (about 52000 files), parses the HTML and builds a roughly 24 MB JSON index. After that it runs off the ready index and starts in seconds. An agent gets four tools: searching functions and methods by name in Russian or English, getting detailed info on a function, prefix-based completion, and validating a function call's syntax. A separate 1cskills skill for OpenCode ships alongside it, with rules on compilation directives, module regions, the query language and project structure, activated on .bsl and .os files.
Who it is for. For 1C developers in OpenCode who need syntax validation and function reference lookups without manually digging through documentation.
Good fit when
- You need fast lookup of 1C platform functions by their Russian or English name
- You want an agent to validate a function call's syntax before inserting code
- You work in OpenCode and are ready to install the local 1cskills skill
Not a fit when
- The 1C 8.3.x or 8.5.x platform is not installed on the machine: the server cannot find the reference file
- The 7z archiver is unavailable and cannot be installed
Example request
Find the СтрДлина function in the 1C reference and check the syntax of my call СтрДлина("текст", 1)MCP
- Transport
- stdio
- Authentication
- not required
Limitations
The first run takes 1-2 minutes to unpack and index, and 7z must be installed and in PATH. The server looks for the 1C platform in a fixed list of standard paths, so a nonstandard install may need manual intervention. The README states directly that the whole project was created with OpenCode.
How to disable. Remove the 1c-syntax block from opencode.jsonc and, optionally, the 1c-syntax-mcp folder with the syntax_tree.json index.
FAQ
Do you need to download the reference separately?
No, the server finds and unpacks shcntx_ru.hbk from the installed platform on first run by itself.
Does it work with English function names?
Yes, search and completion support both Russian and English identifiers.
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 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
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
Ten MCP servers for 1C development: platform reference, targeted object dump and load, COM, storage, file search and BSL Language Server
1C AI development environment
1C AI Development Environment
1C development environment with an MCP server offering 10 tools: 11 BSL analyzers, JSON DSL to XML, dependency graph, and EPF build without 1C
1C built-in language help: a local MCP server
itcoolmcplang1c
A Rust MCP server that gives an agent the 1C built-in language reference from your own platform install, with a knowledge base built and kept entirely local
README in short
The README describes the server's automatic initialization, setting up a virtual environment and the mcp dependency, the 7z requirement, opencode.jsonc setup for Windows and Linux/Mac, four MCP tools with parameters and examples, the separate 1cskills skill with OpenCode install instructions, and a detailed troubleshooting section for locating the platform and the shcntx_ru.hbk file.