Skip to main content

mcp-rosreestr

MCP server for Russian Rosreestr open cadastral data — lookup by cadastral number, address or coordinates; cadastral value with history.

PyPI version License: MIT MCP-compatible Python 3.11+


MCP-сервер (Model Context Protocol — открытый протокол интеграции AI-агентов с внешними источниками данных), дающий ИИ-агенту прямой доступ к публичным открытым данным Росреестра РФ через НСПД (Национальная система пространственных данных, nspd.gov.ru) и Публичную кадастровую карту (ПКК) как fallback.

Часть семейства MCP-серверов atomno (atomno-mcp.ru). Открытый MIT — никакой PII собственников, только публичные характеристики объекта.

Что умеет

Тул Что делает
lookup_by_cadastral По кадастровому номеру (например, 77:01:0001066:1234) возвращает площадь, год постройки, кадастровую стоимость, ВРИ (вид разрешённого использования), адрес.
lookup_by_address По свободному тексту адреса возвращает список найденных объектов с их КН (кадастровыми номерами) и confidence score.
lookup_by_coords По геокоординатам (lat/lon в WGS84) показывает все объекты в этой точке (земельные участки, здания, помещения).
get_cadastral_value Текущая кадастровая стоимость + локально кэшированная история переоценок.

Быстрый старт

# Через uvx (рекомендуется — без установки)
uvx atomno-mcp-rosreestr

# Или через pipx
pipx install atomno-mcp-rosreestr
mcp-rosreestr

Подключение в Cursor

Добавьте в ~/.cursor/mcp.json:

{
  "mcpServers": {
    "rosreestr": {
      "command": "uvx",
      "args": ["atomno-mcp-rosreestr"]
    }
  }
}

Подключение в Claude Desktop

%APPDATA%/Claude/claude_desktop_config.json (Windows) или ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "rosreestr": {
      "command": "uvx",
      "args": ["atomno-mcp-rosreestr"]
    }
  }
}

CLI

atomno-mcp-rosreestr --help          # usage
atomno-mcp-rosreestr --version       # 0.1.0
atomno-mcp-rosreestr --check-config  # кэш + upstream NSPD/PKK
atomno-mcp-rosreestr --transport http --port 8000  # сетевой транспорт

Health-check

atomno-mcp-rosreestr --check-config

Выведет состояние локального кэша и доступность upstream-сервисов (NSPD, PKK).

Конфигурация (env vars)

Canonical-имена — с префиксом MCP_ROSREESTR_. Legacy ROSREESTR_* поддерживаются с DeprecationWarning.

Переменная Описание Default
MCP_ROSREESTR_HTTP_TIMEOUT HTTP-таймаут для upstream-запросов (секунды) 15.0
MCP_ROSREESTR_CACHE_PATH Путь к локальной SQLite-базе с кэшем ./mcp_rosreestr_cache.sqlite
MCP_ROSREESTR_CACHE_TTL_LIVE TTL «живых» данных (стоимость) в секундах 86400 (24 ч)
MCP_ROSREESTR_CACHE_TTL_STATIC TTL «статичных» данных (площадь, год) в секундах 604800 (7 дней)
MCP_ROSREESTR_USER_AGENT Кастомный User-Agent для upstream atomno-mcp-rosreestr/<version> ...
MCP_ROSREESTR_LOG_LEVEL Уровень логирования (DEBUGCRITICAL) INFO
MCP_ROSREESTR_API_KEY Pro-фичи (не требуется для open client)

Источники данных

  • НСПД (nspd.gov.ru) — основной источник, актуальный геопортал Росреестра.
  • ПКК (pkk5.rosreestr.ru) — fallback (legacy), используется только если НСПД не отвечает или объект не найден.

API оба недокументированные и могут меняться. Клиент написан defensively: при изменении формы ответа поля деградируют до None, а не падают.

Кэширование и ratelimit

  • Все ответы кэшируются локально в SQLite с раздельными TTL: 24 часа для волатильных (стоимость), 7 дней для статичных (адрес, площадь, год постройки).
  • История кадастровых стоимостей накапливается локально из периодических обращений (open-данные не выдают полный аудит-trail).
  • Запросы к upstream — politely-paced, без агрессивного fan-out.

Тестирование

git clone https://github.com/atomno-mcp/mcp-rosreestr
cd mcp-rosreestr
pip install -e ".[dev]"
pytest -v

Disclaimer / правовые ограничения

  • Не аффилирован с Федеральной службой государственной регистрации, кадастра и картографии (Росреестр), НСПД (nspd.gov.ru) или Публичной кадастровой картой (ПКК). Независимый open-source клиент к публичным API.
  • Только открытые данные — кадастровые номера, площадь, адрес, кадастровая стоимость. Нет ПДн (персональных данных) собственников, паспортов, телефонов.
  • Законное использование — due-diligence, оценка недвижимости, аналитика на основе публичных реестров. Не для сбора ПДн, спама или обхода ограничений upstream.
  • Данные носят справочный характер; для юридически значимых решений заказывайте официальную выписку ЕГРН (Единый государственный реестр недвижимости).
  • Upstream API недокументированы и могут меняться без предупреждения. Используете на свой риск.

Лицензия

MIT © Atomno

Ссылки

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

atomno_mcp_rosreestr-0.1.6.tar.gz (28.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

atomno_mcp_rosreestr-0.1.6-py3-none-any.whl (25.5 kB view details)

Uploaded Python 3

File details

Details for the file atomno_mcp_rosreestr-0.1.6.tar.gz.

File metadata

  • Download URL: atomno_mcp_rosreestr-0.1.6.tar.gz
  • Upload date:
  • Size: 28.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.4

File hashes

Hashes for atomno_mcp_rosreestr-0.1.6.tar.gz
Algorithm Hash digest
SHA256 b48ad3c775bc6e4c8197206ff34fb152222c96dc9bc0278a956b0086ebe8b197
MD5 8090f6b0fb1706c86d66981c752e1898
BLAKE2b-256 e4f5f6cb44f7551c8472ec36d9fc329f827f50ead3f256b8bc01b4e06169c335

See more details on using hashes here.

File details

Details for the file atomno_mcp_rosreestr-0.1.6-py3-none-any.whl.

File metadata

File hashes

Hashes for atomno_mcp_rosreestr-0.1.6-py3-none-any.whl
Algorithm Hash digest
SHA256 b82fb5b1cb37ad19404a27bd88d7d26f432fedca6419f3cf42659bcb61192425
MD5 c7718b462aae53228adb3d61c3086aae
BLAKE2b-256 ed5d293e1a031bf1fa92722cdd02d276be488533219ab60d077a77d8d49db2f7

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page