Skip to content

Releases: atomno-mcp/mcp-fns-check

v0.1.3

Choose a tag to compare

@atomnos atomnos released this 05 Jul 17:10

Full Changelog: v0.1.2...v0.1.3

v0.1.2

Choose a tag to compare

@atomnos atomnos released this 04 Jul 05:23

chore: MCP Registry metadata (mcp-name marker in README)

v0.1.1 — фикс CLI UX (argparse)

Choose a tag to compare

@atomnos atomnos released this 25 Apr 05:11

Patch-релиз: фикс CLI UX. Публичный API MCP-тулзов (check_contractor + 6 гранулярных) без изменений — обновление безопасно для всех уже работающих интеграций (Cursor, Claude Desktop, Claude Code, Cline).

PyPI: https://pypi.org/project/atomno-mcp-fns-check/0.1.1/

Fixed

  • atomno-mcp-fns-check --help и --version больше не подвешиваются. В v0.1.0 CLI игнорировал argparse-флаги и сразу запускал FastMCP-stdio-сервер, который висел на неинициализированном stdin. Пользователь, поставивший пакет с PyPI, не мог даже узнать установленную версию. Теперь флаги обрабатываются argparse до mcp.run().

Added

  • --transport {stdio,http,sse,streamable-http} (по умолчанию stdio). Позволяет запускать MCP-сервер через сетевые транспорты без обёртки — полезно для hosted-сценариев и отладки. Для http-транспортов добавлены --host (default 127.0.0.1) и --port (default 8000).
  • --log-level {DEBUG,INFO,WARNING,ERROR,CRITICAL} с приоритетом над переменной MCP_FNS_LOG_LEVEL (она продолжает работать как env-фолбэк). Невалидное значение MCP_FNS_LOG_LEVEL теперь явно валит процесс с exit-2 вместо silent-fallback на INFO — чтобы опечатки в .env не маскировались.
  • 18 новых CLI-тестов (tests/test_cli.py) покрывают --help, --version, валидацию транспорта, приоритет CLI/env для log-level и loud-fail на невалидный env. Итого: 265 passed, 86% coverage (было 247 / 85%).

Internal

  • main(argv: list[str] | None = None) -> int — точка входа теперь принимает argv и возвращает exit-code. Это internal-контракт, вызывается только через console-скрипт atomno-mcp-fns-check. Публичный Python-API не изменился.

Полный changelog: https://github.com/atomno-labs/mcp-fns-check/blob/main/CHANGELOG.md

v0.1.0 — первый публичный релиз

Choose a tag to compare

@atomnos atomnos released this 24 Apr 20:04

atomno-mcp-fns-check v0.1.0 — первый публичный релиз

7 MCP-тулзов для проверки российских контрагентов через открытые данные ФНС и сопутствующих реестров.

Тулзы

Тул Назначение
check_contractor Главный. Полный due diligence одним вызовом — детерминированный вердикт + рекомендации
check_inn Карточка ЕГРЮЛ/ЕГРИП по ИНН
check_ogrn Карточка по ОГРН/ОГРНИП
get_legal_status Жизненный статус (active / bankruptcy / liquidated / …) с обогащением из ЕФРСБ
get_okveds Коды ОКВЭД с расшифровкой по ОКВЭД-2
get_directors_history Текущий руководитель (полная история — после Open Data slice ЕГРЮЛ в v0.5+)
check_for_red_flags 8 риск-проверок (4 базовые + 4 расширенные)

Источники (публичные, без токенов)

  • egrul.nalog.ru — ЕГРЮЛ/ЕГРИП.
  • bankrot.fedresurs.ru — ЕФРСБ.
  • pb.nalog.ru — Прозрачный бизнес ФНС (налоговые долги, отсутствие отчётности).
  • fssp.gov.ru — Банк данных исполнительных производств ФССП.
  • kad.arbitr.ru — Картотека арбитражных дел.
  • nalog.gov.ru/opendata/ — Open Data ФНС (через CLI atomno-mcp-fns-etl).

Качество релиза

  • 247 тестов, 85% coverage.
  • Все внешние HTTP замоканы через respx — никаких живых запросов в CI.
  • 10 smoke-архетипов контрагентов покрывают все 4 значения verdict_action (safe_to_proceed / manual_review_required / high_risk_do_not_proceed / impossible_contractor_defunct).
  • Graceful degradation — отказ источника не валит ответ, ошибки собираются в risks.errors[], вердикт понижается до manual_review_required.
  • Маркер py.typed (PEP 561) — IDE и mypy видят type-info из коробки.
  • ИНН руководителя маскируется (XXX*****YY) согласно 152-ФЗ (минимизация ПДн).

Установка

pip install atomno-mcp-fns-check

Через uv или pipx:

uv pip install atomno-mcp-fns-check
pipx install atomno-mcp-fns-check

Подключение к MCP-клиентам

Работает с Claude Desktop, Cursor, Claude Code CLI, Cline — любым MCP-совместимым агентом. Сниппеты конфигов под каждый клиент — в README.

Лицензия

MIT. См. LICENSE.

Disclaimer

Сервис — агрегатор поверх публично доступных данных российских реестров (ФНС, ЕФРСБ, КАД, ФССП). Не аффилирован ни с одним из этих ведомств. Использование на свой риск. Не заменяет профессиональный юридический или финансовый due diligence.