1C Context MCP
An MCP server that unpacks 1C's .hbk help, indexes it in Qdrant and gives the agent search over API, snippets and standards
- 4 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- Runs mcp, qdrant, redis and ingest-worker services in Docker
- Indexes platform help and configuration metadata, does not write to the 1C database
Install
- Works in
- Services
Manual install
make quick-start-prebuiltDownloads a ready public Qdrant/BM25 index and brings up MCP at http://localhost:8050/mcp with no local .hbk help.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Runs mcp, qdrant, redis and ingest-worker services in Docker
- Indexes platform help and configuration metadata, does not write to the 1C database
This is third-party code. Review the repository files before installing.
What it does
The project parses 1C platform help in .hbk format into structured JSONL, builds a vector index in Qdrant from it and runs an MCP server for searching API references, code snippets, development standards and configuration metadata. It runs as several Docker Compose services: mcp serves MCP over HTTP, qdrant holds the indexes, redis holds the ingest cache, and ingest-worker builds the index and runs a scheduled watchdog. You can bring up a ready public index with no local 1C help via make quick-start-prebuilt, or build your own index from your own .hbk and configuration metadata export.
Who it is for. For 1C developers who want Cursor or another agent to surface platform API, ready snippets and standards directly from their configuration's context.
Good fit when
- You need fast search over 1C platform help right inside the agent instead of switching to web docs
- You have your own .hbk help and configuration metadata worth indexing
- You need MCP over streamable HTTP with ready Cursor configuration examples
Not a fit when
- You do not want to run a multi-service Docker Compose setup just for an MCP server
- You have no .hbk help of your own and the public demo index does not fit your data (the author forbids publishing backups built from private or NDA configurations)
- You need a lightweight search without Qdrant and Redis
Example request
Find the method signature for long-running operations in 1C help and show a ready call snippetMCP
- Transport
- http
- Authentication
- not required
Environment variables
HOST_HELP_SOURCE_BASE- Path to local 1C platform .hbk help for building your own index
Limitations
Full operation needs Docker and several services: mcp, qdrant, redis, ingest-worker. The public demo index on Mail.ru Cloud is for evaluation only, not production. Your own index needs 1C platform .hbk help and a metadata export via the tools/1c/MetadataExport.epf processing. The project changes actively, and its license is not machine-readable via the GitHub API.
How to disable. Stop the stack with docker compose down and remove the server from your MCP client settings.
FAQ
Do I have to build my own index?
No, make quick-start-prebuilt downloads and restores a public demo index with no local .hbk help needed.
How often does a self-built index refresh?
The watchdog runs on startup and every 10 minutes, a full ingest runs daily at 3:00, or you can trigger it manually with make ingest.
Discussion
No questions or reviews yet.
Related
All 1C:Enterprise tools1C 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
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 for searching the 1C platform syntax reference: global functions, object methods and properties via Elasticsearch
A container set: 1C configuration structure export, a Qdrant vector database and an MCP server that finds objects by meaning
Ten MCP servers for 1C development: platform reference, targeted object dump and load, COM, storage, file search and BSL Language Server
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
README in short
The bilingual README describes a four-service pipeline and two start paths: a quick one with a public prebuilt index or a full one with local 1C help. It shows make commands for running, ingesting and reindexing with cleanup, the streamable HTTP endpoint and a Cursor config example. The repository has a separate docs/cursor-examples folder with ready SKILL.md files and rules for different ways of using this MCP with Cursor.