xbsl-mcp-docs
MCP-сервер с полнотекстовым поиском по локальной документации 1С:Элемент, включая свои markdown и PDF
- 16 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Запускает локальный HTTP-сервер, который индексирует документацию 1С:Элемент в SQLite
- Админ-API без включенной авторизации принимает файлы и запускает переиндексацию от любого клиента
Установка
- Работает в
- Сервисы
Ручная установка
docker compose up --build -dПосле создания .env с путями TOPICS_HOST_PATH и STDLIB_HOST_PATH и каталогов data/uploads, data/index.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Запускает локальный HTTP-сервер, который индексирует документацию 1С:Элемент в SQLite
- Админ-API без включенной авторизации принимает файлы и запускает переиндексацию от любого клиента
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер индексирует заранее подготовленные каталоги документации topics и stdlib по платформе 1С:Элемент через SQLite FTS5, поддерживает html, markdown и PDF и умеет инкрементально переиндексировать только измененные файлы. Пользователь может добавлять свои файлы в markdown и PDF, включая кириллические имена, через админ-API или встроенный браузерный UI. Поиск и документы отдаются агенту по MCP через Streamable HTTP endpoint /mcp, есть отдельный UI для поиска и администрирования индекса. Запускается локально через uv или в Docker, все пути к источникам задаются переменными окружения.
Для кого. Для разработчиков, которые работают с платформой 1С:Элемент и хотят, чтобы агент искал ответы прямо в локальной документации и в собственных заметках.
Подходит, если
- Есть локальная документация 1С:Элемент (topics, stdlib) и нужен быстрый полнотекстовый поиск по ней из агента
- Нужно добавлять свои markdown или PDF заметки в общий индекс для поиска
- Важна инкрементальная переиндексация без пересборки всего индекса заново
Не подходит, если
- Нет подготовленных каталогов документации topics и stdlib для 1С:Элемент
- Нужен поиск по обычной 1С:Предприятие, а не по платформе Элемент
Пример запроса к агенту
Найди в документации 1С:Элемент раздел про работу со справочниками и покажи основные методыMCP
- Транспорт
- http
- Авторизация
- не нужна
Переменные окружения
TOPICS_ROOTобязательная- Путь к каталогу основной документации 1С:Элемент при локальном запуске.
STDLIB_ROOTобязательная- Путь к каталогу справочника стандартной библиотеки при локальном запуске.
ADMIN_USERNAME- Логин для basic auth на административных маршрутах, опционально.
ADMIN_PASSWORDсекрет- Пароль для basic auth на административных маршрутах, опционально.
Ограничения
Проект не поставляет саму документацию 1С:Элемент, только индексирует уже подготовленные каталоги, путь к которым нужно взять отдельно. Basic auth для админ-маршрутов опциональна и по умолчанию не включена. Реиндексация после смены путей в Docker требует ручного обновления .env и перезапуска контейнера.
Как отключить. Остановите сервер командой docker compose down или прервите процесс uv run xbsl-mcp-docs, затем удалите сервер из конфигурации MCP клиента.
Частые вопросы
Можно загружать свои файлы в индекс?
Да, через POST /admin/upload или встроенный UI администрирования, поддерживаются markdown и PDF, включая кириллические имена.
Нужен ли Docker обязательно?
Нет, сервер можно запустить локально через uv sync и uv run xbsl-mcp-docs при наличии Python 3.12+.
Обсуждение
Вопросов и отзывов пока нет.
Stdio MCP-сервер, который индексирует XML-выгрузку структуры 1С и код в SQLite и отдает агенту поиск по объектам и процедурам
MCP-поиск по документации БСП
BSP Documentation MCP
MCP-сервер для Codex со смысловым поиском по документации Библиотеки стандартных подсистем 1С
MCP-сервер справки платформы 1С
Onec Platform Help MCP Server
MCP и REST сервер с гибридным поиском (BM25 плюс семантика) по официальной справке платформы 1С:Предприятие
MCP-сервер поиска по синтакс-помощнику платформы 1С: глобальные функции, методы и свойства объектов через Elasticsearch
MCP-сервер по документации API платформы 1С прямо из файлов справки shcntx_ru.hbk, с keyword, semantic и hybrid поиском
MCP-сервер OData 1С с JSON-кэшем
MCP сервер для работы с OData 1C
Python MCP-сервер поверх OData 1С: читает и меняет справочники и документы, сохраняет все данные в JSON-файлы для локального анализа без повторных запросов
Коротко о README
README перечисляет возможности (FTS5-поиск, индексация html/md/pdf, инкрементальная переиндексация, встроенный UI), описывает три источника данных (topics, stdlib, uploads), дает пошаговый запуск через Docker Compose и через uv локально, список переменных окружения, карту маршрутов MCP, UI и админ-API, примеры curl-запросов для переиндексации и загрузки файла, и команды для разработки (ruff, pytest).