xbsl-mcp-docs
MCP-сервер с полнотекстовым поиском по локальной документации 1С:Элемент, включая свои markdown и PDF
Низкий риск
Низкий уровень ставим, когда запись в основном дает агенту инструкции и справочные материалы.
Почему такой уровень
- Только индексирует и отдает документы для чтения, не подключается к базе 1С
- Административный API без включенной авторизации может переиндексировать и принимать файлы от кого угодно
Установка
Ручная установка
docker compose up --build -dПосле создания .env с путями TOPICS_HOST_PATH и STDLIB_HOST_PATH и каталогов data/uploads, data/index.
Проверка безопасности
Как мы проверяемНизкий рискНизкий уровень ставим, когда запись в основном дает агенту инструкции и справочные материалы.
- Только индексирует и отдает документы для чтения, не подключается к базе 1С
- Административный 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+.
Похожие
MCP-серверыУтилита 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, воронки и еще около сорока типов
Коротко о README
README перечисляет возможности (FTS5-поиск, индексация html/md/pdf, инкрементальная переиндексация, встроенный UI), описывает три источника данных (topics, stdlib, uploads), дает пошаговый запуск через Docker Compose и через uv локально, список переменных окружения, карту маршрутов MCP, UI и админ-API, примеры curl-запросов для переиндексации и загрузки файла, и команды для разработки (ruff, pytest).