SkillFoxx

v8help: CLI and MCP for 1C help with hybrid search

v8help

An MCP server and CLI for 1C that build full-text and vector indexes over the platform's .hbk help and parse PascalCase Russian identifiers

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

Extended access

Why this level

  • Runs a Python server that extracts 1C help and builds an SQLite index
  • For vector search it sends text to the configured embedder: LM Studio, Ollama or Hugging Face
All reasons and checks
Russian stack

sergeyfedyakov/v8help-mcpAuthor:sergeyfedyakov

Install

Manual install

python -m venv .venv && pip install -e .

Installing registers two console scripts: v8help and v8help-mcp.

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 extracts 1C help and builds an SQLite index
  • For vector search it sends text to the configured embedder: LM Studio, Ollama or Hugging Face

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

What it does

The tool extracts HTML pages from the 1C platform's help container, converts them to Markdown while rewriting internal v8help://... links to relative ones, and builds a SQLite FTS5 full-text index with lexical expansion that can split identifiers like СтрНайтиПоРегулярномуВыражению into their component words. Ranking weighs fields: a match in the title or the Description section outweighs one in the article body. Vector and hybrid search are supported through an OpenAI-compatible embeddings API, with long articles chunked and neighbor metadata attached. Index building is asynchronous: build returns a job_id immediately, progress is tracked via build_status, and search is not blocked while it runs.

Who it is for. For 1C developers who need precise search over platform help that understands Russian PascalCase identifiers, with optional meaning-based search.

Good fit when

  • You need 1C help search that correctly splits compound Russian identifiers
  • You want both a terminal CLI and an MCP server for an agent from one install
  • You have ready indexes without an installed platform: they can be reused per the docs instead of rebuilding

Not a fit when

  • You need vector search only, without FTS5: the tool is hybrid by default
  • You have neither an installed platform nor a ready index: there is nothing to search without one of them

Example request

Use v8help to find the СтрНайтиПоРегулярномуВыражению method and show its parameters

MCP

Transport
stdio, http
Authentication
not required

Limitations

Rebuilding the index needs an installed 1C:Enterprise platform with a bin folder containing .hbk files; search alone needs just a ready database. Vector or hybrid search needs a configured embedder: LM Studio, Ollama or Hugging Face. A Docker option is documented separately, with the database on a volume and optional index auto-loading.

How to disable. Remove the v8help entry from your MCP client config and, if needed, uninstall the v8help and v8help-mcp console scripts.

FAQ

Is the 1C platform needed for every search?

No, the platform is needed only to build the index; search works from an already built database, and ready indexes exist without an installed platform.

How is the article title weighted in ranking?

The title, description and body fields are weighted 9 to 3 to 1, so a match in the title or method description matters more than one in the body.

Discussion

No questions or reviews yet.

All 1C:Enterprise tools

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

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

MCP serverExtended access1
Russian stack

An MCP server for Claude Code: full-text search over multiple 1C XML+BSL configuration exports in a local SQLite FTS5 database

MCP serverExtended access
Russian stack

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

MCP serverExtended access76
Russian stack

A local read-only MCP server suite for 1C: a Rust code indexer, metadata skills, a prompt gallery and platform help search, with evidence-backed answers

MCP serverExtended access
Russian stack

A SQLite code index with MCP tools for search, call graphs and metadata, including 1C dumps from Designer and EDT

MCP serverExtended access162

README in short

The README describes an MCP tool and CLI for reading, indexing and searching 1C help in .hbk format. It gives a quick start with copying the config, the build and search commands, and links to separate docs on configuration, embeddings, Docker deployment and development. It separately credits the HTML-to-Markdown converter ported from the hbk-to-md project.

README badge

Report a problem