1creader: чтение файловой ИБ 1С

Установка

Ручная установка

git clone https://github.com/vengeoff/1creader.git
cd 1creader
python3 -m venv .venv && .venv/bin/pip install -e .

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Инструмент читает файл 1Cv8.1CD файловой информационной базы 1С без платформы и без выгрузки в XML, разбирает метаданные, тексты модулей BSL, формы и данные справочников и регистров. По результатам строится компактная карта MAP.md для агента, Obsidian vault с картами связей и подсистем в vault/, полные схемы в developer/ и чанки для RAG в ai/retrieval.json. Один и тот же MCP-сервер подключается к Cursor, Claude Code и Codex, инструменты MCP дают доступ к индексу, схемам объектов, модулям, данным справочников и заметкам Obsidian. Есть параллельный CLI onecreader с командами info, ls, obj, module, search, form, catalog-data.

Для кого. Для тех, кто получил чужую или legacy файловую базу 1С без документации и хочет быстро разобраться в структуре без платформы и без выгрузки в XML.

Пример запроса к агенту

Покажи модуль справочника Номенклатура и объясни, как он связан с документами заказов

Ограничения

Поддерживается формат 1CD 8.3.8 и платформа 8.3.8+, более новые форматы файла не заявлены. Инструмент только читает базу, запись не поддерживается ни в каком режиме. Файловая ИБ должна быть доступна как файл на диске, конфигуратор может держать блокировку и мешать чтению. Нужен Python 3.10 и выше.

Как отключить. Удалите запись 1creader из .mcp.json, .cursor/mcp.json или .codex/config.toml и, если не нужны, каталоги .onecreader с артефактами.

MCP

Транспорт

stdio

Авторизация

не нужна

Проверка безопасности

• Инструмент явно только читает базу, запись не поддерживается
• MCP отдает данные справочников и регистров, включая потенциально персональные данные из базы

Коротко о README

README объясняет, зачем читать файловую ИБ напрямую, дает быстрый старт с командой onecreader init, описывает структуру артефактов (MAP.md, vault, developer, ai) и структуру Obsidian vault, приводит фрагменты подключения MCP для Cursor, Claude Code и Codex, таблицу из семи MCP-инструментов и список CLI-команд. В конце перечислено, что читается (справочники, документы, регистры, модули, данные из БД, DBSCHEMA) и честные ограничения по формату и режиму только для чтения.

Похожие