MCP BSL Platform Help Context
MCP-сервер по документации API платформы 1С прямо из файлов справки shcntx_ru.hbk, с keyword, semantic и hybrid поиском
Низкий риск
Низкий уровень ставим, когда запись в основном дает агенту инструкции и справочные материалы.
Почему такой уровень
- Только читает справочные файлы платформы и отдает документацию для чтения
- Не подключается к базе 1С и не выполняет код
Установка
Ручная установка
pip install -e ".[local]"Устанавливает пакет вместе с зависимостями для semantic и hybrid поиска (sentence-transformers, torch).
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер читает бинарный файл справки платформы shcntx_ru.hbk из установки 1С:Предприятие (или использует pre-exported JSON) и дает агенту девять инструментов: поиск по API в трех режимах (keyword, semantic, hybrid), детальную карточку метода или свойства по точному имени, список членов типа, сигнатуры конструкторов, информацию о версии платформы, рекомендации по стилю кода BSL и документацию по строгой типизации с полнотекстовым поиском по ней. Поддерживает несколько версий платформы одновременно с автовыбором ближайшей, три транспорта (stdio, SSE, Streamable HTTP) и русские и английские имена API. Это Python-порт оригинального Kotlin-проекта mcp-bsl-platform-context, с независимым покрытием тестами (359 тестов).
Для кого. Для 1С-разработчиков в Claude Desktop, Cursor или другом MCP-клиенте, которым нужны точные ответы по API платформы вместо приблизительной памяти модели.
Подходит, если
- Нужна точная сигнатура метода или свойства платформы 1С с параметрами и типами
- Нужен поиск по смыслу вопроса на естественном языке о том, как что-то сделать в BSL
- Работаете с несколькими версиями платформы 1С одновременно
Не подходит, если
- Нет доступа к установленной платформе 1С с файлом shcntx_ru.hbk и нет pre-exported JSON
- Нужна справка по прикладной конфигурации, а не по самой платформе
- На CPU-образе Docker нужен semantic или hybrid поиск без внешнего embedding API: по умолчанию доступен только keyword
Пример запроса к агенту
Покажи сигнатуру метода Найти у ТаблицыЗначений и объясни параметр КолонкиОграничения
CPU-образ Docker собирается без локальных ML-моделей и по умолчанию работает только в режиме keyword, для semantic и hybrid нужен внешний OpenAI-совместимый API. Первый запуск с новой embedding-моделью качает ее с HuggingFace. Проект зависит от бинарного формата HBK, поддержка версий платформы ограничена явно указанным диапазоном (до 8.3.27 и новее).
Как отключить. Остановите процесс mcp-bsl-context или контейнер Docker и удалите сервер bsl-context из конфигурации MCP клиента.
MCP
- Транспорт
- stdio, sse, http
- Авторизация
- не нужна
| Переменные окружения | |
|---|---|
| MCP_BSL_PLATFORM_PATH обязательная | Путь к каталогу установки платформы 1С с файлом shcntx_ru.hbk, обязателен для источника данных hbk. |
| MCP_BSL_SEARCH_DEFAULT_MODE | Режим поиска по умолчанию: keyword, semantic или hybrid. |
Проверка безопасности
- Только читает справочные файлы платформы и отдает документацию для чтения
- Не подключается к базе 1С и не выполняет код
Коротко о README
README перечисляет возможности (три режима поиска, мультиверсионность, YAML-конфиг, двуязычность), таблицы MCP-инструментов для поиска и для документации, описание трех стратегий keyword-поиска и RAG-пайплайна для semantic, установку через pip с extras, полный список переменных окружения и CLI-параметров, интеграцию с Claude Desktop и Cursor, запуск в Docker с CPU и GPU профилями, архитектуру пакета по слоям и инструкции для AI-ассистентов по порядку вызова инструментов.
Частые вопросы
Обязательно ли устанавливать локальную ML-модель?
Нет, базовая установка pip install -e . дает только keyword-поиск без ML-зависимостей, semantic и hybrid требуют extras [local] или внешний API.
Можно использовать без установленной платформы 1С?
Да, через источник данных json и заранее подготовленные файлы platform-context-exporter.
Похожие
Утилита Microsoft и MCP-сервер, которые переводят PDF, Word, Excel, PowerPoint, HTML и другие файлы в Markdown для модели
Скиллы Anthropic
Skills
Официальные примеры скиллов Anthropic: документы docx, pdf, pptx, xlsx, дизайн, MCP builder и спецификация Agent Skills
Скилл, который собирает редактируемые PPTX-презентации из PDF, DOCX, ссылок и Markdown с настоящими фигурами, диаграммами и анимациями
Скилл рисует редакторские диаграммы как самостоятельные файлы HTML и SVG: архитектура, блок-схемы, ER, воронки и еще около сорока типов