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 Уровень логирования (DEBUG…CRITICAL) 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

Ссылки

Metadata

Release files for atomno-mcp-rosreestr 0.1.6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for atomno-mcp-rosreestr 0.1.6
File Size Uploaded
atomno_mcp_rosreestr-0.1.6.tar.gz 28.9 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for atomno-mcp-rosreestr 0.1.6
File Interpreter ABI Platform
atomno_mcp_rosreestr-0.1.6-py3-none-any.whl Python 3 none any Details

Total release size: 54.3 kB

Release files / atomno_mcp_rosreestr-0.1.6.tar.gz

Download URL atomno_mcp_rosreestr-0.1.6.tar.gz
Size 28.9 kB
Tags Source
SHA-256 checksum
How to use checksums
b48ad3c775bc6e4c8197206ff34fb152222c96dc9bc0278a956b0086ebe8b197
BLAKE2b-256 checksum
How to use checksums
e4f5f6cb44f7551c8472ec36d9fc329f827f50ead3f256b8bc01b4e06169c335
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.11.4

Release files / atomno_mcp_rosreestr-0.1.6-py3-none-any.whl

Download URL atomno_mcp_rosreestr-0.1.6-py3-none-any.whl
Size 25.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b82fb5b1cb37ad19404a27bd88d7d26f432fedca6419f3cf42659bcb61192425
BLAKE2b-256 checksum
How to use checksums
ed5d293e1a031bf1fa92722cdd02d276be488533219ab60d077a77d8d49db2f7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.11.4

Release history Release notifications | RSS feed

This release

0.1.6 This release

2 release files

0.1.4

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page