MCP BSL Platform Help Context
MCP-сервер по документации API платформы 1С прямо из файлов справки shcntx_ru.hbk, с keyword, semantic и hybrid поиском
- 18 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Запускает Python-сервер, который разбирает файл справки shcntx_ru.hbk из установки 1С
- Для смыслового поиска скачивает модель с HuggingFace или ходит во внешний OpenAI-совместимый API
Установка
- Работает в
- Сервисы
Ручная установка
pip install -e ".[local]"Устанавливает пакет вместе с зависимостями для semantic и hybrid поиска (sentence-transformers, torch).
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Запускает Python-сервер, который разбирает файл справки shcntx_ru.hbk из установки 1С
- Для смыслового поиска скачивает модель с HuggingFace или ходит во внешний OpenAI-совместимый API
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер читает бинарный файл справки платформы 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
Пример запроса к агенту
Покажи сигнатуру метода Найти у ТаблицыЗначений и объясни параметр КолонкиMCP
- Транспорт
- stdio, sse, http
- Авторизация
- не нужна
Переменные окружения
MCP_BSL_PLATFORM_PATHобязательная- Путь к каталогу установки платформы 1С с файлом shcntx_ru.hbk, обязателен для источника данных hbk.
MCP_BSL_SEARCH_DEFAULT_MODE- Режим поиска по умолчанию: keyword, semantic или hybrid.
Ограничения
CPU-образ Docker собирается без локальных ML-моделей и по умолчанию работает только в режиме keyword, для semantic и hybrid нужен внешний OpenAI-совместимый API. Первый запуск с новой embedding-моделью качает ее с HuggingFace. Проект зависит от бинарного формата HBK, поддержка версий платформы ограничена явно указанным диапазоном (до 8.3.27 и новее).
Как отключить. Остановите процесс mcp-bsl-context или контейнер Docker и удалите сервер bsl-context из конфигурации MCP клиента.
Частые вопросы
Обязательно ли устанавливать локальную ML-модель?
Нет, базовая установка pip install -e . дает только keyword-поиск без ML-зависимостей, semantic и hybrid требуют extras [local] или внешний API.
Можно использовать без установленной платформы 1С?
Да, через источник данных json и заранее подготовленные файлы platform-context-exporter.
Обсуждение
Вопросов и отзывов пока нет.
MCP-сервер со справочником платформы 1С и проверкой BSL-кода на соответствие реальному API нужной версии платформы
Справка платформы 1С по MCP
mcp-bsl-platform-context
MCP-сервер со справкой синтакс-помощника 1С: поиск функций, типов, методов, свойств и конструкторов из установленной платформы
MCP-сервер справки платформы 1С
Onec Platform Help MCP Server
MCP и REST сервер с гибридным поиском (BM25 плюс семантика) по официальной справке платформы 1С:Предприятие
MCP-сервер поиска по синтакс-помощнику платформы 1С: глобальные функции, методы и свойства объектов через Elasticsearch
MCP-справочник синтаксиса 1С 8.3
1C Syntax Helper MCP (mcp-1c-helper)
Read-only MCP-сервер ищет по индексу справки платформы 1С:Предприятие 8.3 в Elasticsearch и отдает результат агенту гибридным поиском BM25 плюс эмбеддинги
MCP-сервер с гибридным поиском по 2262 шаблонам кода BSL от сообщества и CRUD веб-интерфейсом на Monaco Editor
Коротко о README
README перечисляет возможности (три режима поиска, мультиверсионность, YAML-конфиг, двуязычность), таблицы MCP-инструментов для поиска и для документации, описание трех стратегий keyword-поиска и RAG-пайплайна для semantic, установку через pip с extras, полный список переменных окружения и CLI-параметров, интеграцию с Claude Desktop и Cursor, запуск в Docker с CPU и GPU профилями, архитектуру пакета по слоям и инструкции для AI-ассистентов по порядку вызова инструментов.