MCP-сервер для инфобаз 1С через COM
1C MCP Server
Python MCP-сервер на Windows, который подключается к файловым и серверным базам 1С через COMConnector и хранит профили подключений с паролями под DPAPI
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- Ограниченные инструменты записи меняют данные подключенной базы 1С за явным подтверждением
- Хранит логин и пароль пользователя 1С в локальных профилях подключения
Установка
Ручная установка
python -m venv .venv && .venv\Scripts\Activate.ps1 && pip install -e .Установка на Windows в виртуальном окружении.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер подключается к базе 1С, переданной в каждом запросе инструмента, через COMConnector на Windows, сам определяет версию платформы по реестру и выбирает нужный коннектор V85 или V83 с откатом при неудаче. Поддерживаются запросы только на чтение, поиск метаданных, чтение объектов, легкая аналитика и ограниченные инструменты записи за явным флагом подтверждения и белым списком из переменных окружения. Можно сохранять профили подключения с адресом, логином и паролем, пароли на Windows хранятся через DPAPI при наличии pywin32, список сохраненных профилей паролей не возвращает. Сервер умеет писать подробный ротируемый диагностический лог с маскировкой паролей.
Для кого. Для 1С-разработчиков на Windows, которым нужен MCP-сервер с явным контролем над операциями записи и безопасным хранением паролей подключения.
Подходит, если
- Нужен доступ агента к файловой или серверной базе 1С именно через COM на Windows
- Важно, чтобы запись в базу требовала явного подтверждения и была ограничена белым списком
- Нужно хранить несколько профилей подключения без хранения паролей в открытом виде
Не подходит, если
- Не работаете на Windows: сервер использует COMConnector и не имеет альтернативы для Linux или macOS
- Не установлена платформа 1С с зарегистрированным COM-коннектором
Пример запроса к агенту
Подключись к тестовой базе 1С по сохраненному профилю demo-file-base и покажи структуру справочника КонтрагентыОграничения
Работает только на Windows с установленной платформой 1С и зарегистрированным COMConnector для версии 8.5 или 8.3. Без pywin32 пароли профилей не защищены DPAPI. Проект небольшой, лицензия не указана, релизов и звезд нет.
Как отключить. Удалите запись onec-mcp-server из конфигурации MCP-клиента и, если нужно, файл connection-profiles.json с сохраненными профилями.
MCP
- Транспорт
- stdio
- Авторизация
- не нужна
| Переменные окружения | |
|---|---|
| ONEC_MCP_LOG_LEVEL | Уровень диагностического логирования, например DEBUG. |
| ONEC_MCP_LOG_PATH | Путь к файлу ротируемого диагностического лога. |
Проверка безопасности
- Ограниченные инструменты записи меняют данные подключенной базы 1С за явным подтверждением
- Хранит логин и пароль пользователя 1С в локальных профилях подключения
Коротко о README
README на английском описывает Python MCP-сервер поверх COMConnector для файловых и серверных баз 1С. Даны требования к платформе и коннектору, установка через venv и pip install -e ., запуск командой onec-mcp-server поверх stdio, настройка диагностического лога через переменные окружения и структура сохраняемого профиля подключения с адресом базы.
Частые вопросы
Возвращает ли сервер сохраненные пароли?
Нет, инструмент list_connection_profiles никогда не возвращает пароли, только метаданные профиля.
Как ограничена запись в базу?
Инструменты записи требуют явного флага подтверждения и ограничены белым списком, заданным через переменные окружения.
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything