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
- 22 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- Starts a server, an embedding service and Qdrant in Docker
- Indexes copied 1C help files and does not connect to a database
Install
- Works in
- Services
Manual install
git clone https://github.com/rzateev/onec-help-mcp.git && cd onec-help-mcp && docker compose up -dAfter copying shcntx_ru.hbk and shcntx_root.hbk into data/help1c/<version>.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Starts a server, an embedding service and Qdrant in Docker
- Indexes copied 1C help files and does not connect to a database
This is third-party code. Review the repository files before installing.
What it does
The server parses the platform help files (shcntx_ru.hbk and shcntx_root.hbk), which need to be copied from a 1C installation, and builds an index in Qdrant using its own embedding service. An agent gets five tools: searching the whole help in natural language, exact API element search, getting a full element card with its signature and examples, listing a type's methods and properties, and version management (indexing, listing indexed versions). It supports several platform versions at once, each stored as a separate collection. The whole stack, the server itself, the embedding service and Qdrant, comes up with one docker compose up command and needs no external cloud dependencies. A REST API on the same port is also available for use without an MCP session, for example from scripts or Claude Code skills.
Who it is for. For 1C developers in Cursor or Claude Desktop who want precise answers from the platform help right in their IDE, without switching to a browser.
Good fit when
- You need exact lookup of a 1C platform method or property signature by name
- You need search by the meaning of a question, not just exact matches
- You have Docker and the help files from an installed platform, and are ready to index the version once
Not a fit when
- You do not have Docker or cannot run three containers (server, embedding, Qdrant)
- You do not have access to shcntx_ru.hbk and shcntx_root.hbk from a platform install
- You need help for a specific application configuration, not the platform itself
Example request
Find the HTTPСоединение.ОтправитьДляОбработки method in the 1C help and show its parametersMCP
- Transport
- http
- Authentication
- not required
Limitations
The README gives conflicting license information: a badge at the top says Non-Commercial, while a section at the bottom says MIT License with attribution to Roman Zateev; the LICENSE file in the repository should be treated as authoritative. First indexing of a version takes 5-15 minutes on CPU or 2-5 minutes on GPU. Help files must be copied manually from a platform install; there is no automatic download.
How to disable. Stop the stack with docker compose down and remove the onec-platform-help server from your client's mcp.json.
FAQ
Is an external service needed for embeddings?
No, the embedding service is part of the docker-compose stack and runs locally in CPU or GPU mode.
Can it be used without MCP?
Yes, all tools are also available through the REST API on the same port, for example for automation scripts.
Discussion
No questions or reviews yet.
Related
All 1C:Enterprise toolsAn MCP server that unpacks 1C's .hbk help, indexes it in Qdrant and gives the agent search over API, snippets and standards
Standalone Rust MCP for 1C help
mcp-1c-help
A lightweight Rust MCP server with HTTP/SSE transport that searches the official 1C:Enterprise 8.3 platform help via SQLite FTS5
An MCP server for the 1C platform API docs read straight from shcntx_ru.hbk help files, with keyword, semantic and hybrid search
An 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
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
README in short
The README describes hybrid search (BM25 plus semantic), a three-step install (clone, copy help files, docker compose up), Cursor setup via mcp.json, a table of five MCP tools, REST request examples with curl, an architecture diagram with Qdrant and the embedding service, a common issues section, and links to detailed docs on tools, the REST API, deployment and architecture.