MCP BSL Platform Help Context
MCP-сервер для доступа к документации API платформы 1С:Предприятие
Python-порт mcp-bsl-platform-context (Kotlin/Spring Boot).
Power your agent
पब्लिशर का इंस्टॉल। PlugMCP एंडपॉइंट नहीं।
Host a copy with our keys and logs.
रजिस्ट्री में अभी कोई पैकेज्ड रिलीज़ नहीं है। रिपॉज़िटरी का README देखें.
रिमोट URL या आपकी मशीन पर कमांड? दोनों इंस्टॉल में क्या अंतर है
PlugMCP पर चलाएँ
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
लॉन्चपब्लिशर से
MCP-сервер для доступа к документации API платформы 1С:Предприятие
Python-порт mcp-bsl-platform-context (Kotlin/Spring Boot).
MCP-сервер: документация API платформы 1С, строгая типизация BSL, стандарты кода. Keyword, semantic и hybrid поиск для AI-ассистентов.
Ответы формируются на русском языке в Markdown. Для метода и конструктора выводится строка синтаксиса из справки, параметры с маркером обязательности, типом, описанием и значением по умолчанию, возвращаемое значение. Метод с несколькими вариантами вызова выводится по вариантам (Вариант синтаксиса: ...). Маркер обязательности выводится только когда он есть в справке.
## Найти
```
Найти(<Значение>, <Колонки>)
```
**Параметры:**
- `Значение` (обязательный) - Тип: Произвольный. Искомое значение.
- `Колонки` (необязательный) - Тип: Строка. Список имен колонок, разделенных запятыми, по которым производится поиск. Значение по умолчанию: Пустая строка.
Осуществляет поиск значения в указанных колонках таблицы значений.
**Возвращаемое значение:** Тип: СтрокаТаблицыЗначений, Неопределено. Строка, в которой содержится искомое значение.
Инструмент search поддерживает три режима (параметр mode, по умолчанию из конфигурации):
RAG-пайплайн: DocumentBuilder → EmbeddingProvider → Qdrant embedded → Reranker
Модели по умолчанию:
ai-forever/ru-en-RoSBERTaDiTy/cross-encoder-russian-msmarcoПровайдеры: local (sentence-transformers) или openai-compatible (любой API в формате OpenAI)
pip install -e . # Базовая установка (keyword search)
pip install -e ".[dev]" # + pytest для разработки
pip install -e ".[local]" # + sentence-transformers, torch (semantic/hybrid search)
Скопируйте config.example.yml в config.yml и настройте под своё окружение:
cp config.example.yml config.yml
mcp-bsl-context -c config.yml
Приоритет конфигурации: YAML < переменные окружения (MCP_BSL_*) < CLI-аргументы.
Основные секции: server, platform, search, embeddings, reranker, storage, index, docs.
--config, -c Путь к YAML-файлу конфигурации
--platform-path, -p Путь к каталогу установки 1С
--platform-version Предпочтительная версия платформы (e.g., 8.3.20)
--mode, -m Транспорт: stdio (по умолчанию), sse или streamable-http
--port Порт для HTTP-сервера (по умолчанию: 8080)
--data-source Источник данных: hbk или json
--json-path Путь к каталогу с JSON-файлами
--verbose, -v Включить отладочное логирование
mcp-bsl-context -c config.yml # Полная конфигурация из YAML
mcp-bsl-context -c config.yml -p /opt/1cv8/x86_64 # YAML + CLI override
mcp-bsl-context -p /opt/1cv8/x86_64 # Автоопределение последней версии
mcp-bsl-context -p /opt/1cv8/x86_64 --platform-version 8.3.20 # Ближайшая к 8.3.20
mcp-bsl-context -p /path -m streamable-http --port 8080 # Streamable HTTP транспорт
mcp-bsl-context -p /path --data-source json --json-path /path # JSON источник
Добавьте в claude_desktop_config.json:
{
"mcpServers": {
"bsl-context": {
"command": "python",
"args": ["-m", "mcp_bsl_context", "-p", "/opt/1cv8/x86_64/8.3.25.1257"]
}
}
}
Добавьте в .cursor/mcp.json:
{
"mcpServers": {
"bsl-context": {
"command": "python",
"args": ["-m", "mcp_bsl_context", "-p", "C:\\Program Files\\1cv8\\8.3.25.1257"]
}
}
}
Укажите путь к родительскому каталогу, и сервер автоматически найдёт все установленные версии:
# Linux: /opt/1cv8/x86_64 содержит 8.3.22.2838/, 8.3.25.1257/, ...
mcp-bsl-context -p /opt/1cv8/x86_64
# Выбрать конкретную версию (будет найдена ближайшая доступная)
mcp-bsl-context -p /opt/1cv8/x86_64 --platform-version 8.3.20
Streamable HTTP — актуальный HTTP-транспорт в спецификации MCP, заменяющий устаревший SSE. Основные отличия:
/mcp вместо двух (/sse + /messages) — проще настройка и проксированиеmcp-bsl-context -p /opt/1cv8/x86_64/8.3.25.1257 -m streamable-http --port 8080
Подключение клиента:
{
"mcpServers": {
"bsl-context": {
"url": "http://localhost:8080/mcp"
}
}
}
Примечание: SSE-режим (
-m sse) по-прежнему поддерживается для обратной совместимости.
В docker-compose.yml нужно указать путь к каталогу установки платформы 1С, в котором находится файл shcntx_ru.hbk.
volumes:
# Linux:
- /opt/1cv8/x86_64/8.3.25.1257:/data/platform:ro
# Windows (Docker Desktop):
# - "C:/Program Files/1cv8/8.3.25.1257:/data/platform:ro"
docker compose up -d # CPU + API providers
docker compose --profile gpu up -d # GPU + локальные модели
docker compose --profile json up -d # JSON data source
CPU-образ собирается без локальных ML-моделей, поэтому в сервисе mcp-bsl-context задан MCP_BSL_SEARCH_DEFAULT_MODE: keyword. Для semantic/hybrid поиска в этом образе нужен внешний embedding API (embeddings.provider: openai-compatible): опишите его в config.yml и раскомментируйте монтирование ./config.yml:/home/mcpuser/config.yml:ro - файл по этому пути entrypoint передает серверу как --config.
docker build -t mcp-bsl-context .
# HBK-данные
docker run -d \
-v /opt/1cv8/x86_64/8.3.25.1257:/data/platform:ro \
-p 8080:8080 \
mcp-bsl-context
# JSON-данные
docker run -d \
-e MCP_BSL_DATA_SOURCE=json \
-v ./json-data:/data/json:ro \
-p 8080:8080 \
mcp-bsl-context
docker inspect --format='{{.State.Health.Status}}' mcp-bsl-context
mcp_bsl_context/
├── config.py # AppConfig — YAML + env + CLI merge
├── domain/ # Доменный слой (все dataclasses frozen)
│ ├── entities.py # Definition, MethodDefinition, PropertyDefinition, PlatformTypeDefinition
│ ├── enums.py # ApiType (METHOD, PROPERTY, TYPE, CONSTRUCTOR)
│ ├── exceptions.py # Иерархия исключений
│ ├── value_objects.py # SearchQuery, SearchOptions, PlatformVersion
│ ├── services.py # ContextSearchService
│ └── docs_service.py # DocsInfoService (строгая типизация, guideline)
│
├── infrastructure/
│ ├── hbk/ # Парсер бинарного формата HBK
│ │ ├── container_reader.py # Бинарный контейнер
│ │ ├── content_reader.py # ZIP-распаковка, TOC + FileStorage
│ │ ├── context_reader.py # Оркестратор чтения
│ │ ├── pages_visitor.py # Visitor: обход дерева страниц
│ │ ├── toc/ # TOC: токенизатор, парсер, дерево
│ │ └── parsers/ # HTML-парсеры страниц (BeautifulSoup)
│ │ ├── html_handler.py # Разбор страницы на блоки (синтаксис, параметры, описание...)
│ │ ├── params.py # Варианты синтаксиса, параметры, тип и значение по умолчанию
│ │ └── *_parser.py # Метод, свойство, тип, конструктор, перечисление
│ │
│ ├── json_loader/ # Альтернативный источник: JSON
│ ├── search/ # Поисковые движки
│ │ ├── indexes.py # HashIndex, StartWithIndex
│ │ ├── strategies.py # 4 стратегии keyword-поиска
│ │ ├── engine.py # SimpleSearchEngine (keyword)
│ │ ├── semantic_engine.py # SemanticSearchEngine (Qdrant + embeddings)
│ │ └── hybrid_engine.py # HybridSearchEngine (RRF + rerank)
│ │
│ ├── embeddings/ # ML-модели
│ │ ├── provider.py # EmbeddingProvider (local/API)
│ │ ├── reranker.py # Reranker (cross-encoder, local/API)
│ │ └── document_builder.py # Entities → embeddable text + Qdrant payload
│ │
│ └── storage/ # Хранилище и репозиторий
│ ├── storage.py # PlatformContextStorage (thread-safe, lazy)
│ ├── repository.py # PlatformRepository (фасад)
│ ├── loader.py # PlatformContextLoader
│ ├── mapper.py # Маппинг сущностей
│ └── version_discovery.py # VersionDiscovery (мультиверсионность)
│
├── presentation/
│ └── formatter.py # Markdown-форматтер для MCP-ответов
│
├── docinfo/ # Встроенная документация
│ ├── strict-types.md # Строгая типизация BSL
│ └── guideline.md # Рекомендации по стилю кода
│
├── server.py # FastMCP сервер (9 инструментов)
└── __main__.py # CLI (click) + YAML config
4 стратегии с приоритетами:
ai-forever/ru-en-RoSBERTa (или API-провайдер)DiTy/cross-encoder-russian-msmarco)storage.qdrant_path и переиспользуется между запусками; индекс, собранный другой версией формата (в том числе версией 0.x сервера), пересобирается автоматически при первом semantic/hybrid запросеПри использовании этого MCP-сервера рекомендуется:
Начинайте с search для нахождения нужных элементов API. Используйте конкретные термины 1С, а не общие описания.
Уточняйте через info — после нахождения нужного элемента получите полную документацию по точному имени.
Навигация по типам: используйте get_members для обзора всех методов/свойств типа, затем get_member для конкретного.
Конструкторы: если нужно создать объект, используйте get_constructors для получения сигнатур.
Строгая типизация: для вопросов о типизации BSL используйте get_strict_typing_info (сначала topic='topics' для списка тем).
Стиль кода: get_coding_guideline содержит полные рекомендации по написанию кода 1С.
Режимы поиска:
keyword — быстрый, для точных имён API (НайтиПоСсылке, ValueTable)semantic — для запросов на естественном языке ("как добавить строку в таблицу")hybrid — лучшее качество, комбинирует оба подходаВерсии платформы: get_platform_info покажет текущую версию и доступные.
pip install -e ".[dev]"
pytest -v # Все тесты (359)
pytest -v tests/test_search_engine.py # Один модуль
pytest -v tests/test_search_engine.py::test_name # Один тест
Сервер читает файл shcntx_ru.hbk из каталога установки платформы 1С:Предприятие. Это бинарный контейнер, содержащий:
Поддерживаются версии HBK до 8.3.27+ включительно (multi-page data chains, изменённые TOC-коды языков, CSS-классы V8SH_heading/V8SH_chapter).
Альтернативно можно использовать pre-exported JSON (через platform-context-exporter).
См. CHANGELOG.md.
MIT
MCP-сервер: документация API платформы 1С, строгая типизация BSL, стандарты кода. Keyword, semantic и hybrid поиск для AI-ассистентов.
टूल
अभी टूल सूची नहीं है। रिमोट सर्वर को पहले हेल्थ चेक के बाद सूची मिलती है।
FAQ
इस पेज पर Cursor, Claude Desktop, Claude Code या VS Code के लिए stdio कॉन्फ़िग कॉपी करें। यह पब्लिशर का इंस्टॉल इस्तेमाल करता है, PlugMCP प्रॉक्सी नहीं।
इस रिकॉर्ड में कोई ज़रूरी एनवायरनमेंट वेरिएबल दर्ज नहीं है।
MCP Bsl Platform Help Context stdio पर लोकल चलता है।
पिछली जाँच 2026-10-28 को हुई। MCP-сервер: документация API платформы 1С, строгая типизация BSL, стандарты кода. Keyword, semantic и hybrid поиск для AI-ассистентов.