1creader: чтение файловой ИБ 1С
1creader
Read-only MCP и CLI, которые читают файловую ИБ 1С напрямую из 1Cv8.1CD и строят карту конфигурации для ИИ-агента и Obsidian
- 9 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Запускает Python-сервер, который разбирает файл 1Cv8.1CD без платформы
- Отдает агенту данные справочников и регистров, где обычно есть клиенты, сотрудники и контрагенты
- Запись в базу не поддерживается
Установка
- Работает в
- Сервисы
Ручная установка
git clone https://github.com/vengeoff/1creader.git
cd 1creader
python3 -m venv .venv && .venv/bin/pip install -e .Установка из исходников.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Запускает Python-сервер, который разбирает файл 1Cv8.1CD без платформы
- Отдает агенту данные справочников и регистров, где обычно есть клиенты, сотрудники и контрагенты
- Запись в базу не поддерживается
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Инструмент читает файл 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.
Подходит, если
- Нужно разобраться в чужой или устаревшей конфигурации 1С по файлу 1Cv8.1CD
- Нужна карта конфигурации для агента в Cursor, Claude Code или Codex без выгрузки в EDT или XML
- Нужна навигационная база в Obsidian с картами подсистем и связей объектов
Не подходит, если
- Нужна запись изменений в базу: инструмент только читает
- Файловая ИБ в формате новее 1CD 8.3.8, который проект пока не поддерживает
- База занята конфигуратором и заблокирована для чтения файла
Пример запроса к агенту
Покажи модуль справочника Номенклатура и объясни, как он связан с документами заказовMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Ограничения
Поддерживается формат 1CD 8.3.8 и платформа 8.3.8+, более новые форматы файла не заявлены. Инструмент только читает базу, запись не поддерживается ни в каком режиме. Файловая ИБ должна быть доступна как файл на диске, конфигуратор может держать блокировку и мешать чтению. Нужен Python 3.10 и выше.
Как отключить. Удалите запись 1creader из .mcp.json, .cursor/mcp.json или .codex/config.toml и, если не нужны, каталоги .onecreader с артефактами.
Частые вопросы
Нужна ли платформа 1С для работы?
Нет, инструмент читает файл 1Cv8.1CD напрямую и не требует установленной платформы.
Можно посмотреть данные справочников, а не только структуру?
Да, инструмент config_catalog_data и команда catalog-data читают данные из таблиц БД, а не только схему объекта.
Обсуждение
Вопросов и отзывов пока нет.
Локальный read-only набор MCP-серверов для 1С: Rust-индексатор кода, скиллы метаданных, галерея промптов и поиск по справке платформы
Среда разработки 1С с MCP-сервером на 10 инструментов: 11 анализаторов BSL, JSON DSL в XML, граф зависимостей и сборка EPF без 1С
Stdio MCP-сервер, который индексирует XML-выгрузку структуры 1С и код в SQLite и отдает агенту поиск по объектам и процедурам
MCP-сервер для Claude Code: полнотекстовый поиск по XML+BSL выгрузкам нескольких конфигураций 1С в локальной SQLite-базе с FTS5
1C Agent Platform: три MCP-сервера для 1С
1C Agent Platform
Платформа из трех MCP-серверов для чтения, записи и интеллектуальных операций с конфигурациями и инфобазами 1С:Предприятие, с bearer-аутентификацией по HTTP
Универсальный MCP-сервер 1С (только чтение)
Universal 1C MCP Server (Read-Only)
Строго read-only MCP-сервер поверх HTTP-сервиса 1С: 39 инструментов для метаданных, запросов, бухгалтерии и отчетов
Из блога
Коротко о README
README объясняет, зачем читать файловую ИБ напрямую, дает быстрый старт с командой onecreader init, описывает структуру артефактов (MAP.md, vault, developer, ai) и структуру Obsidian vault, приводит фрагменты подключения MCP для Cursor, Claude Code и Codex, таблицу из семи MCP-инструментов и список CLI-команд. В конце перечислено, что читается (справочники, документы, регистры, модули, данные из БД, DBSCHEMA) и честные ограничения по формату и режиму только для чтения.