bit-1c-help
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MCP_PORT | No | Port on 127.0.0.1 for the HTTP entry. No default is provided intentionally; required when using the HTTP entry. | |
| BIT_1C_HELP_ROOT | No | Path to the local help documentation root. Default is 'kb/'. | |
| MCP_SERVICE_NAME | No | Service name that appears in the service field of /health response. | |
| MCP_ALLOWED_HOSTS | No | Comma-separated list of additional allowed Host header values. | |
| MCP_ALLOWED_ORIGINS | No | Comma-separated list of allowed Origin header values. Default is empty. | |
| BIT_1C_HELP_LOG_PATH | No | Path to the JSONL search log. Default is 'build/logs/search.jsonl'. | |
| BIT_1C_HELP_GIT_COMMIT | No | Explicit commit SHA for builds outside a Git repository. | |
| BIT_1C_HELP_INDEX_ROOT | No | Path to the index directory. Default is 'build/index'. | |
| BIT_1C_HELP_LOG_QUERIES | No | Set to 'true' to log query texts. Default is false. | |
| MCP_ALLOW_EPHEMERAL_PORT | No | Set to '1' to allow MCP_PORT=0. Needed for tests. | |
| BIT_1C_HELP_LOG_MAX_BYTES | No | Log file size before rotation. Default is 20 MB. | |
| BIT_1C_HELP_LOG_MAX_FILES | No | Maximum number of rotation files. Default is 5. | |
| BIT_1C_HELP_MAX_FILE_BYTES | No | Maximum size of an indexed file. Default is 2000000. | |
| BIT_1C_HELP_BUILD_INFO_PATH | No | Alternative path to BUILD-INFO.json. | |
| BIT_1C_HELP_INDEX_CACHE_LIMIT | No | Number of indexes kept in memory simultaneously. Default is 3. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search_1c_platform_helpA | Офлайн полнотекстовый поиск по локальной базе знаний 1С:Предприятие. НАЧИНАТЬ ОТСЮДА для вопросов, ответ на которые лежит в документации, а не в коде конкретной конфигурации. Охват: синтакс-помощник платформы (BSL API, объекты/методы/свойства/события; версии 8.3.27.1989 и 8.3.15.1869); документация платформы 8.3.27 (администрирование, кластер, конфигуратор, параметры запуска); стандарты разработки v8std; методики metod8dev (архитектура, производительность, эксплуатация); документация БСП 3.1.11 (3000+ файлов) и БСП из поставки (SSL); VanessaAutomation (Gherkin, шаги); YAxUnit (юнит-тесты, assert/matcher). Query на русском или английском. Фильтр source сужает поиск до раздела (полный список и когда какой брать — в list_1c_platform_help_sources). В отличие от MCP v8std (онлайн v8std.ru): это ЛОКАЛЬНЫЙ офлайн-индекс, покрывает те же стандарты плюс БСП/VA/YAxUnit, работает без сети. Для синтаксиса из ЖИВОЙ запущенной ИБ есть отдельный get_bsl_syntax_help у 1c-mcp-toolkit. |
| get_1c_platform_help_documentA | Прочитать документ целиком, постранично (offset + maxChars, продолжать по nextOffset). Брать, когда нужен контекст вокруг найденного или файл целиком. path — из выдачи search_1c_platform_help. |
| get_1c_platform_help_sectionA | Прочитать точный фрагмент по стабильному id из выдачи search. Предпочтительнее get_1c_platform_help_document, когда нужен ровно найденный раздел без лишнего контекста. |
| reindex_1c_platform_helpA | СЛУЖЕБНЫЙ. Инкрементально обновить индекс каталога справки: переиндексируются только изменившиеся файлы. Обычно не нужен — вызывать только при рассинхроне после обновления или добавления нескольких файлов справки. Полную пересборку этот инструмент НЕ делает: force=true возвращает отказ, потому что пересборка всего корпуса не укладывается в таймаут запроса. Для неё есть отдельная команда, node ./scripts/build-index.js --force, запускаемая вне обслуживания запросов. |
| list_1c_platform_help_sourcesA | Read-only. Список доступных разделов (source) с их назначением (useWhen). Вызывать перед search с фильтром source, чтобы выбрать нужный раздел. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 5 tools
Each tool has a distinct role: search, read document, read section, list sources, and reindex. The two getters are clearly separated by document-level vs section-level retrieval with explicit guidance on which to prefer.
All tools follow the pattern [verb]_1c_platform_help[_object] with snake_case throughout. Verbs (search, get, get, reindex, list) are consistent and the two get_ tools are differentiated by their object suffixes.
Five tools form a tight, well-scoped set for an offline help retrieval server. There are no redundant tools and nothing feels missing.
The domain is offline 1C help access, and the set covers the full lifecycle: discover sources, search, retrieve documents/sections, and maintain the index. No obvious operational gaps remain for the stated purpose.