SkillFoxx

MCP BSL Platform Help Context

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

  • 18 ★ on the repository
  • Last commit
  • MIT
MCP server

Extended access

Why this level

  • Runs a Python server that parses the shcntx_ru.hbk help file from the 1C installation
  • For semantic search it downloads a model from HuggingFace or calls an external OpenAI-compatible API
All reasons and checks
Russian stack

desko77/mcp-bsl-platform-help-contextAuthor:Desko77

Install

Manual install

pip install -e ".[local]"

Installs the package along with the dependencies for semantic and hybrid search (sentence-transformers, torch).

Access and checks

How we review

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

  • Runs a Python server that parses the shcntx_ru.hbk help file from the 1C installation
  • For semantic search it downloads a model from HuggingFace or calls an external OpenAI-compatible API

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

What it does

The server reads the binary shcntx_ru.hbk platform help file from a 1C:Enterprise install (or uses pre-exported JSON) and gives an agent nine tools: API search in three modes (keyword, semantic, hybrid), a detailed method or property card by exact name, a type's member list, constructor signatures, platform version info, BSL coding style guidance, and strict-typing documentation with full-text search over it. It supports several platform versions at once with automatic selection of the nearest one, three transports (stdio, SSE, Streamable HTTP), and both Russian and English API names. It is a Python port of the original Kotlin mcp-bsl-platform-context project, with its own independent test coverage (359 tests).

Who it is for. For 1C developers in Claude Desktop, Cursor or another MCP client who need precise platform API answers instead of the model's approximate memory.

Good fit when

  • You need the exact signature of a 1C platform method or property with parameters and types
  • You need natural-language search about how to do something in BSL
  • You work with several 1C platform versions at once

Not a fit when

  • You have no access to an installed 1C platform with shcntx_ru.hbk and no pre-exported JSON
  • You need help for an application configuration, not the platform itself
  • You need semantic or hybrid search on the CPU Docker image without an external embedding API: only keyword works by default there

Example request

Show me the signature of the Найти method on ТаблицаЗначений and explain the Колонки parameter

MCP

Transport
stdio, sse, http
Authentication
not required

Environment variables

MCP_BSL_PLATFORM_PATH required
Path to the 1C platform install folder containing shcntx_ru.hbk, required for the hbk data source.
MCP_BSL_SEARCH_DEFAULT_MODE
Default search mode: keyword, semantic or hybrid.

Limitations

The CPU Docker image ships without local ML models and defaults to keyword mode only; semantic and hybrid search need an external OpenAI-compatible API. The first run with a new embedding model downloads it from HuggingFace. The project depends on the binary HBK format, with platform version support limited to the explicitly stated range (up to 8.3.27 and newer).

How to disable. Stop the mcp-bsl-context process or Docker container and remove the bsl-context server from your MCP client config.

FAQ

Is a local ML model required?

No, the base pip install -e . gives only keyword search with no ML dependencies; semantic and hybrid need the [local] extras or an external API.

Can it be used without an installed 1C platform?

Yes, via the json data source with files prepared in advance by platform-context-exporter.

Discussion

No questions or reviews yet.

All 1C:Enterprise tools
Russian stack

MCP server with the 1C platform reference and validation of BSL code against the real API of a chosen platform version

MCP serverExtended access33

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 access207

1C Platform Help MCP Server

Onec Platform Help MCP Server

Russian stack

An MCP and REST server with hybrid search (BM25 plus semantic) over the official 1C:Enterprise platform help

MCP serverExtended access22
Russian stack

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

MCP serverExtended access76

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

An MCP server with hybrid search over 2262 community BSL code templates and a CRUD web interface built on Monaco Editor

MCP serverBroad access31

README in short

The README lists capabilities (three search modes, multi-version support, YAML config, bilingual support), tables of MCP tools for search and documentation, a description of the three keyword search strategies and the semantic RAG pipeline, pip installation with extras, a full list of environment variables and CLI flags, Claude Desktop and Cursor integration, running in Docker with CPU and GPU profiles, the package's layered architecture, and instructions for AI assistants on tool call order.

README badge

Report a problem