MCP-поиск по документации БСП
BSP Documentation MCP
MCP-сервер для Codex со смысловым поиском по документации Библиотеки стандартных подсистем 1С
Низкий риск
Низкий уровень ставим, когда запись в основном дает агенту инструкции и справочные материалы.
Почему такой уровень
- Только читает и ищет по локальной документации, ничего не меняет в базе 1С
- Текст поискового запроса уходит в OpenRouter для получения embedding
Установка
Ручная установка
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\install.ps1Запускать в каталоге клонированного или распакованного репозитория на Windows. Установщик копирует сервер в %USERPROFILE%\.codex\mcp\bsp-docs-mcp и создает окружение Python.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер ищет рекомендуемые методы в документации БСП (Библиотеки стандартных подсистем 1С) не по точному совпадению слов, а по смыслу запроса. В комплекте уже есть исходная документация версии 3.1.11 и готовый индекс SQLite FTS5, поэтому строить индекс заново не нужно. Агент сначала определяет версию БСП проекта по файлу ParentConfigurations.bin, затем ищет раздел и читает его целиком. Для превращения текстового запроса в вектор сервер обращается к OpenRouter с моделью embedding.
Для кого. Для 1С-разработчиков, которые пишут код на БСП и хотят, чтобы Codex сам находил нужный программный интерфейс в документации.
Подходит, если
- Нужно быстро найти рекомендуемый метод БСП по описанию задачи, а не по точному названию
- Codex работает с конфигурацией 1С, использующей БСП версии 3.1.x
- Нужно определить версию БСП проекта по файлу конфигурации
Не подходит, если
- Работаете не на Windows: установщик и инструкция рассчитаны только на Windows 10/11
- Нет ключа OpenRouter и не хочется заводить внешний аккаунт ради поиска по документации
- Нужна документация БСП версии, отличной от семейства 3.1
Пример запроса к агенту
Определи версию БСП этого проекта и найди рекомендуемый программный интерфейс для длительных операцийОграничения
Установка и инструкция рассчитаны только на Windows, нужен Python 3.12 и ключ OpenRouter для векторизации новых запросов. Лицензия в репозитории не указана. Готовый индекс покрывает только семейство БСП 3.1, для других версий документацию и индекс нужно строить отдельно. Проект небольшой, поддерживается одним автором.
Как отключить. Удалите блок mcp_servers.bsp_docs из %USERPROFILE%\.codex\config.toml и папку %USERPROFILE%\.codex\mcp\bsp-docs-mcp.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| OPENROUTER_API_KEY обязательная, секрет | Ключ OpenRouter для построения вектора поискового запроса |
Проверка безопасности
- Только читает и ищет по локальной документации, ничего не меняет в базе 1С
- Текст поискового запроса уходит в OpenRouter для получения embedding
Коротко о README
README на русском подробно ведет по установке через install.ps1 или вручную: клонирование, виртуальное окружение Python, переменная OPENROUTER_API_KEY и блок конфигурации Codex. Описаны четыре MCP-инструмента: определение версии БСП, поиск, чтение раздела и список установленных версий. Отдельно объяснено, сколько токенов OpenRouter тратится на построение и на поиск, и как агенту выбирать версию БСП, не угадывая ее самому.
Частые вопросы
Нужно ли строить индекс самому?
Нет, для версии БСП 3.1.11 индекс уже входит в комплект. OpenRouter нужен только для превращения нового поискового запроса в вектор.
Работает ли сервер без Windows?
README и install.ps1 рассчитаны только на Windows 10/11, других инструкций в репозитории нет.
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything