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
Low risk
We rate an entry low when it mostly gives the agent instructions and reference material.
Why this level
- Only indexes and serves platform help text for reading
- Does not connect to a 1C database and does not execute code
Install
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>.
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 parametersLimitations
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.
MCP
- Transport
- http
- Authentication
- not required
Security check
- Only indexes and serves platform help text for reading
- Does not connect to a 1C database and does not execute code
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.
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.
Related
Microsoft's utility and MCP server that turn PDF, Word, Excel, PowerPoint, HTML and other files into Markdown for models
Anthropic skills
Skills
Anthropic's official skill examples: docx, pdf, pptx and xlsx documents, design, MCP builder and the Agent Skills spec
A skill that builds editable PPTX decks from PDF, DOCX, URLs and Markdown with native shapes, charts and animations
A skill that draws editorial diagrams as standalone HTML and SVG files: architecture, flowcharts, ER, funnels and about forty more types