1C Syntax Helper MCP Server
An MCP server for searching the 1C platform syntax reference: global functions, object methods and properties via Elasticsearch
- 75 ★ on the repository
- Last commit
Extended access
Why this level
- Starts Elasticsearch and an HTTP service without authentication
Install
- Works in
- Services
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/1c-syntax-helper-mcp-serverDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Starts Elasticsearch and an HTTP service without authentication
This is third-party code. Review the repository files before installing.
What it does
The server parses the platform help file in .hbk format, indexes it into Elasticsearch and answers agent questions about the built-in language. Through three tools the agent looks up global functions, object methods and properties, and gets a full object description with all methods, properties and events. Indexing runs in the background on first start, and reindexing can be triggered by a flag or through the API. The author targets one shared server on a local network for several developers.
Who it is for. For 1C development teams who want the agent to check the official syntax reference instead of guessing methods.
Good fit when
- The agent invents non-existent 1C built-in language methods
- You want one help service shared by several developers in the office
- You need the list of methods and properties of a platform object quickly
Not a fit when
- You need search over your own configuration code and metadata rather than platform help
- No resources for Elasticsearch: the service uses about 2 GB of RAM
Example request
Check the syntax reference for the parameters of the ValueTable.GroupBy methodMCP
- Transport
- http
- Authentication
- not required
Environment variables
ELASTICSEARCH_HOST- Elasticsearch host
ELASTICSEARCH_PORT- Elasticsearch port
REINDEX_ON_STARTUP- Reindex help on startup
Limitations
The .hbk help file is not included and must come from your own platform install. Requires Docker and Elasticsearch; the service has no built-in auth, so keep it inside a trusted network. The repository has no license file, although the README mentions MIT. Client config examples differ between documents.
How to disable. Remove the 1c-syntax-helper server from the client MCP settings and stop the containers with docker compose down.
FAQ
Where do I get the .hbk file?
From your installed 1C:Enterprise platform folder; the author targets version 8.3.24 and newer.
How do I update help after a new platform release?
Stop the services, replace the .hbk file, start them again and trigger an index rebuild through the API.
Discussion
No questions or reviews yet.
Related
All 1C:Enterprise tools1C 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
A stdio MCP server that indexes a 1C structure XML export and code into SQLite and gives an agent search over objects and procedures
An MCP server that unpacks 1C's .hbk help, indexes it in Qdrant and gives the agent search over API, snippets and standards
1C Platform Help MCP Server
Onec Platform Help MCP Server
An MCP and REST server with hybrid search (BM25 plus semantic) over the official 1C:Enterprise platform help
Alternatives
Tools by other authors for the same tasks.
- 1C Syntax Helper MCP Server1 Repository stars
README in short
The README covers a local Docker Compose run with the help file in data/hbk, building images for AMD64 and ARM64 servers and connecting VS Code. It shows the architecture: a shared Elasticsearch plus a FastAPI server used by several workstations. It lists the three MCP tools, the reindex and help update procedure, and diagnostics through logs and status endpoints.