mcp-rosreestr

Servidor MCP para dados cadastrais abertos do Rosreestr russo — consulta por número cadastral, endereço ou coordenadas; valor cadastral com histórico.

GitHub
1

Documentação

mcp-rosreestr

Servidor MCP do Rosreestr: objeto por número cadastral, endereço ou coordenadas, valor cadastral com histórico. Apenas informações públicas, sem dados sobre proprietários.

Dados cadastrais russos para agentes de IA.

PyPI version License: MIT MCP-compatible Python 3.11+

Dados abertos do Rosreestr via NSPD (Sistema Nacional de Dados Espaciais, nspd.gov.ru); o Mapa Cadastral Público é a fonte alternativa.

Parte da família de servidores MCP atomno (atomno-mcp.ru). MIT aberto — sem PII de proprietários, apenas características públicas do objeto.

O que faz

FerramentaO que faz
lookup_by_cadastralPor número cadastral (por exemplo, 77:01:0001066:1234) retorna área, ano de construção, valor cadastral, VRI (tipo de uso permitido), endereço.
lookup_by_addressPor texto livre de endereço retorna uma lista de objetos encontrados com seus números cadastrais (NC) e pontuação de confiança.
lookup_by_coordsPor coordenadas geográficas (lat/lon em WGS84) mostra todos os objetos naquele ponto (terrenos, edifícios, salas).
get_cadastral_valueValor cadastral atual + histórico de reavaliações armazenado em cache local.

Início rápido

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

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

Conexão no Cursor

Adicione em ~/.cursor/mcp.json:

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

Conexão no Claude Desktop

%APPDATA%/Claude/claude_desktop_config.json (Windows) ou ~/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

Exibirá o estado do cache local e a disponibilidade dos serviços upstream (NSPD, PKK).

Configuração (variáveis de ambiente)

Nomes canônicos — com prefixo MCP_ROSREESTR_. Os legados ROSREESTR_* são suportados com DeprecationWarning.

VariávelDescriçãoPadrão
MCP_ROSREESTR_HTTP_TIMEOUTTimeout HTTP para requisições upstream (segundos)15.0
MCP_ROSREESTR_CACHE_PATHCaminho para o banco SQLite local com cache./mcp_rosreestr_cache.sqlite
MCP_ROSREESTR_CACHE_TTL_LIVETTL de dados "vivos" (valor) em segundos86400 (24 h)
MCP_ROSREESTR_CACHE_TTL_STATICTTL de dados "estáticos" (área, ano) em segundos604800 (7 dias)
MCP_ROSREESTR_USER_AGENTUser-Agent personalizado para upstreamatomno-mcp-rosreestr/<version> ...
MCP_ROSREESTR_LOG_LEVELNível de log (DEBUG…CRITICAL)INFO
MCP_ROSREESTR_API_KEYRecursos Pro (não necessário para cliente aberto)—

Fontes de dados

  • NSPD (nspd.gov.ru) — fonte principal, geoportal atualizado do Rosreestr.
  • PKK (pkk5.rosreestr.ru) — fallback (legado), usado apenas se o NSPD não responder ou o objeto não for encontrado.

Ambas as APIs não são documentadas e podem mudar. O cliente foi escrito de forma defensiva: se o formato da resposta mudar, os campos degradam para None, em vez de falhar.

Cache e limite de requisições

  • Todas as respostas são armazenadas em cache localmente em SQLite com TTLs separados: 24 horas para dados voláteis (valor), 7 dias para dados estáticos (endereço, área, ano de construção).
  • O histórico de valores cadastrais é acumulado localmente a partir de consultas periódicas (dados abertos não fornecem trilha de auditoria completa).
  • Requisições ao upstream são feitas de forma educada, sem fan-out agressivo.

Testes

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

Aviso legal / restrições legais

  • Não afiliado ao Serviço Federal de Registro Estadual, Cadastro e Cartografia (Rosreestr), NSPD (nspd.gov.ru) ou ao Mapa Cadastral Público (PKK). Cliente open-source independente para APIs públicas.
  • Apenas dados abertos — números cadastrais, área, endereço, valor cadastral. Sem dados pessoais (PII) de proprietários, passaportes, telefones.
  • Uso legal — due diligence, avaliação de imóveis, análise baseada em registros públicos. Não para coleta de PII, spam ou contorno de restrições upstream.
  • Os dados têm caráter informativo; para decisões juridicamente relevantes, solicite a declaração oficial do EGRN (Registro Único Estadual de Imóveis).
  • As APIs upstream não são documentadas e podem mudar sem aviso. Use por sua conta e risco.

Licença

MIT © Atomno

Links