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
MCP server

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
All reasons and checks
Russian stack

rzateev/onec-help-mcp

Install

Manual install

git clone https://github.com/rzateev/onec-help-mcp.git && cd onec-help-mcp && docker compose up -d

After copying shcntx_ru.hbk and shcntx_root.hbk into data/help1c/<version>.

Access and checks

How we review

Extended 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 parameters

MCP

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.

Russian stack

An MCP server that unpacks 1C's .hbk help, indexes it in Qdrant and gives the agent search over API, snippets and standards

MCP serverExtended access4Repository stars
Russian stack

A lightweight Rust MCP server with HTTP/SSE transport that searches the official 1C:Enterprise 8.3 platform help via SQLite FTS5

MCP serverExtended access
Russian stack

An MCP server for the 1C platform API docs read straight from shcntx_ru.hbk help files, with keyword, semantic and hybrid search

MCP serverExtended access18Repository stars
Russian stack

An MCP server for searching the 1C platform syntax reference: global functions, object methods and properties via Elasticsearch

MCP serverExtended access76Repository stars

1C 8.3 syntax helper MCP

1C Syntax Helper MCP (mcp-1c-helper)

Russian stack

A read-only MCP server searches 1C:Enterprise 8.3 docs in Elasticsearch and returns results via hybrid BM25 plus embedding search

MCP serverExtended access5Repository stars

1C platform reference over MCP

mcp-bsl-platform-context

Russian stack

An MCP server with the 1C syntax assistant reference: search functions, types, methods, properties and constructors from the installed platform

MCP serverExtended access207Repository stars

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.

README badge

Report a problem