1C Syntax Helper MCP Server

A shared Elasticsearch-backed MCP server for searching 1C syntax help from VS Code: functions, object methods, properties, code examples

  • 1 ★ on the repository
  • Last commit
MCP server

Extended access

Why this level

  • Starts Elasticsearch and an HTTP search server for 1C platform help in Docker
  • The service is open on the local network with no user authentication
All reasons and checks
Russian stack

royfincher25-source/1c-syntax-helper-mcp

A similar tool with a larger community: 1C Syntax Helper MCP Server, 76 ★ on the repository

Install

Manual install

docker compose up -d

Brings up Elasticsearch and the FastAPI MCP server; the .hbk file must be placed in data/hbk first.

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • Starts Elasticsearch and an HTTP search server for 1C platform help in Docker
  • The service is open on the local network with no user authentication

This is third-party code. Review the repository files before installing.

What it does

The server parses a 1C platform documentation .hbk file, indexes it in Elasticsearch, and exposes search tools over MCP: a universal find_1c_help search, full and quick reference for an element, context-filtered search, a list of an object's methods, properties and events, and code usage examples. It is designed as a shared service on one machine in a local network: one Elasticsearch instance and one documentation .hbk file serve up to eight concurrent VS Code users with no individual authentication.

Who it is for. For 1C developer teams who want one shared fast-search service over the platform's syntax helper instead of local docs for each developer.

Good fit when

  • You need fast lookup of global functions and object methods from VS Code
  • You want one shared reference service for the team instead of a local install for each developer

Not a fit when

  • You need authentication or access control: the server runs without it over the local network
  • You need automatic documentation refresh: the .hbk update is a manual, once-a-year process

Example request

Find all methods and properties of the ТаблицаЗначений object and show a usage example of Добавить

MCP

Transport
http
Authentication
not required

Limitations

Documentation is refreshed manually about once a year by swapping the .hbk file and reindexing. The service does not authenticate users and assumes a trusted local network. The project carries a lot of internal refactoring report files, a sign the code is not yet fully settled.

How to disable. Stop the containers with docker compose down and remove the server entry from VS Code's settings.json.

FAQ

Is authentication required to connect?

No, the service is designed as a shared local server with no individual authentication.

How often is the reference data refreshed?

Documentation is updated manually about once a year by replacing the .hbk file and reindexing via /index/rebuild.

Discussion

No questions or reviews yet.

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
Russian stack

An MCP server for searching and validating 1C syntax that unpacks the reference straight from your installed platform on first run

MCP serverExtended access34Repository 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
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

README in short

The README credits an Infostart article as the original idea, describes an architecture with a shared Elasticsearch instance and a FastAPI MCP server on localhost:8002, a table of nine MCP tools, a yearly .hbk update cycle, and a recipe for sending Cyrillic text through a file instead of a CLI argument due to Windows encoding issues.

README badge

Report a problem