SkillFoxx

Type a name, a task or a service

1C Syntax Helper MCP Server

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

MCP serverMedium riskRussian stack

antonio1c/1c-syntax-helper-mcpAuthor: Antonio1C

Install

docker compose up -d
curl http://localhost:8000/health

Run inside the cloned repository after copying the help file to data/hbk/1c_documentation.hbk.

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

What it does

The server parses the platform help file in .hbk format, indexes it into Elasticsearch and answers agent questions about the built-in language. Through three tools the agent looks up global functions, object methods and properties, and gets a full object description with all methods, properties and events. Indexing runs in the background on first start, and reindexing can be triggered by a flag or through the API. The author targets one shared server on a local network for several developers.

Who it is for. For 1C development teams who want the agent to check the official syntax reference instead of guessing methods.

Good fit when

  • The agent invents non-existent 1C built-in language methods
  • You want one help service shared by several developers in the office
  • You need the list of methods and properties of a platform object quickly

Not a fit when

  • You need search over your own configuration code and metadata rather than platform help
  • No resources for Elasticsearch: the service uses about 2 GB of RAM

Example request

Check the syntax reference for the parameters of the ValueTable.GroupBy method

Limitations

The .hbk help file is not included and must come from your own platform install. Requires Docker and Elasticsearch; the service has no built-in auth, so keep it inside a trusted network. The repository has no license file, although the README mentions MIT. Client config examples differ between documents.

How to disable. Remove the 1c-syntax-helper server from the client MCP settings and stop the containers with docker compose down.

MCP

Transport
http
Authentication
not required
Environment variables
ELASTICSEARCH_HOST
Elasticsearch host
ELASTICSEARCH_PORT
Elasticsearch port
REINDEX_ON_STARTUP
Reindex help on startup

Security check

  • Starts Elasticsearch and an HTTP service without authentication

README in short

The README covers a local Docker Compose run with the help file in data/hbk, building images for AMD64 and ARM64 servers and connecting VS Code. It shows the architecture: a shared Elasticsearch plus a FastAPI server used by several workstations. It lists the three MCP tools, the reindex and help update procedure, and diagnostics through logs and status endpoints.

FAQ

Where do I get the .hbk file?

From your installed 1C:Enterprise platform folder; the author targets version 8.3.24 and newer.

How do I update help after a new platform release?

Stop the services, replace the .hbk file, start them again and trigger an index rebuild through the API.

Editors’ pick

A skills library that gives coding agents a development process: brainstorming, planning, TDD, subagents and code review

PluginMedium risk286.7K
Editors’ pick

Small composable skills for engineering with agents: plan grilling, TDD, bug diagnosis, code review and architecture

SkillLow risk262.1K
Editors’ pick

GitHub toolkit for spec-driven development: the specify CLI adds agent commands and skills to a project, from principles to implementation

CLIMedium risk136.8K

Reference MCP servers

Model Context Protocol servers

Editors’ pick

Official reference MCP servers: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time and Everything

MCP serverMedium risk90.3K