mcp-egrul
MCP-сервер ЕГРЮЛ и ЕГРИП: реквизиты, руководитель и учредители компаний и ИП по открытым данным ФНС на своем сервере
Установка
uvx atomno-mcp-egrulТакже pipx install atomno-mcp-egrul или pip install atomno-mcp-egrul.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер ищет российские компании и ИП по ИНН, ОГРН или названию и возвращает карточку со статусом, адресом, руководителем и учредителями с долями. Есть массовая проверка до 100 ИНН за вызов, а контрольные цифры идентификаторов проверяются до обращения к данным. В открытом режиме данные берутся из локальной базы SQLite, которую наполняют импортом выгрузок ФНС, скачанных вручную, с ежедневным обновлением по расписанию. При заданном ключе ATOMNO_API_KEY запросы уходят на платный хостинг автора.
Для кого. Юристам, бухгалтерам, продажникам и разработчикам, которые проверяют контрагентов по госреестру.
Подходит, если
- Нужно проверить статус и руководителя компании по ИНН
- Нужно сверить список контрагентов пачкой
- Нужен собственный слепок реестра без зависимости от платных API
Не подходит, если
- Нужны данные на сегодня, а локальная выгрузка обновляется с задержкой
- Нет места и времени на импорт полного слепка реестра
Пример запроса к агенту
Проверь по ЕГРЮЛ компании с этими ИНН: кто руководитель, кто учредители и не ликвидированы ли ониОграничения
Без импорта база пуста: выгрузки ФНС весят около 15 ГБ, скачиваются вручную после принятия лицензии на сайте налоговой, первый импорт занимает до часа. Данные отстают от реестра на время публикации выгрузки. Хостинговый Pro-режим платный, а часть его функций автор еще разрабатывает.
Как отключить. Уберите блок egrul из конфигурации MCP-клиента. Docker-версию остановите docker compose down, файл mcp_egrul_data.sqlite можно удалить вручную.
MCP
- Транспорт
- stdio
- Авторизация
- не нужна
| Переменные окружения | |
|---|---|
| MCP_EGRUL_DB | Путь к SQLite-базе со слепком реестра |
| MCP_EGRUL_DUMPS_DIR | Каталог с выгрузками ФНС |
| ATOMNO_API_KEY секрет | Ключ платного хостингового режима |
Проверка безопасности
- Хранит и обрабатывает данные реестра, включая ФИО руководителей и учредителей
- При заданном ключе отправляет запросы на внешний сервис автора
Коротко о README
README на русском перечисляет семь инструментов и способы установки через uvx, pipx или pip, с конфигурациями для Claude Desktop и Cursor. Подробно описан Docker-вариант с импортом выгрузок ФНС и планировщиком, который каждую ночь подхватывает новые архивы. Разобраны коды выхода импорта, переменные окружения и поведение платного хостингового режима без тихого перехода на старые данные. Автор делает упор на полное покрытие тестами. Лицензия MIT.
Частые вопросы
Почему сервер не скачивает выгрузки сам?
Архивы ФНС можно получить только после принятия лицензии на сайте налоговой, поэтому автор оставил скачивание пользователю.
Нужен ли ключ?
Для работы с локальной базой нет. ATOMNO_API_KEY нужен только для платного хостингового режима.
Похожие
166 скиллов для научных задач: биоинформатика, хемоинформатика, клинические данные, геоданные и доступ к 100+ базам
Открытый MCP-сервер Google для баз данных: готовые инструменты для Postgres, MySQL, BigQuery, Spanner и других, плюс свои инструменты в tools.yaml
Экономный по токенам MCP-сервер для PostgreSQL, MySQL, MariaDB, SQL Server и SQLite с режимом только для чтения
Официальный MCP-сервер MongoDB: запросы и агрегации к базам, управление индексами, кластерами Atlas и локальными развертываниями