mcp-rosreestr

mcp-rosreestr

MCP 服务 Rosreestr：按地籍编号、地址或坐标查询对象，并获取含历史记录的地籍价值。仅提供公开信息，不含所有者数据。

面向 AI Agent 的俄罗斯地籍数据。

通过 НСПД（国家空间数据系统，nspd.gov.ru）获取 Rosreestr 的公开数据；公共地籍地图作为备用来源。

属于 atomno MCP 服务系列（atomno-mcp.ru）。MIT 开源——不包含所有者的 PII，仅提供对象的公开属性。

功能

工具	功能
lookup_by_cadastral	按地籍编号（例如 77:01:0001066:1234）返回面积、建成年份、地籍价值、ВРИ（许可用途类型）和地址。
lookup_by_address	按自由格式地址文本返回找到的对象列表，以及对应的 КН（地籍编号）和置信度分数。
lookup_by_coords	按地理坐标（WGS84 中的 lat/lon）显示该位置的所有对象（土地、建筑物、房屋单元）。
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"]
    }
  }
}

命令行

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  # сетевой транспорт

健康检查

atomno-mcp-rosreestr --check-config

将显示本地缓存状态及上游服务（NSPD、PKK）的可用性。

配置（环境变量）

规范名称使用 MCP_ROSREESTR_ 前缀。旧版 ROSREESTR_* 仍受支持，但会发出 DeprecationWarning。

变量	说明	默认值
MCP_ROSREESTR_HTTP_TIMEOUT	上游请求的 HTTP 超时（秒）	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	atomno-mcp-rosreestr/<version> ...
MCP_ROSREESTR_LOG_LEVEL	日志级别（DEBUG…CRITICAL）	INFO
MCP_ROSREESTR_API_KEY	Pro 功能（开放客户端无需此项）	—

数据来源

• НСПД（nspd.gov.ru）——主要来源，Rosreestr 的最新地理门户。
• ПКК（pkk5.rosreestr.ru）——备用来源（旧版），仅在 НСПД 无响应或未找到对象时使用。

两个 API 均未公开文档，且可能发生变化。客户端采用防御式设计：响应格式变化时，字段会降级为 None，而不会导致程序崩溃。

缓存与速率限制

• 所有响应都在本地缓存至 SQLite，并使用不同的 TTL：易变数据（价值）缓存 24 小时，静态数据（地址、面积、建成年份）缓存 7 天。
• 地籍价值历史通过定期查询在本地累积（开放数据不提供完整的审计轨迹）。
• 上游请求采用温和的节奏，不进行激进的扇出请求。

测试

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

Ссылки

• GitHub
• PyPI
• Issues / баг-трекер
• MCP Catalog (Glama.ai)
• Семейство atomno MCP: atomno-mcp.ru