mcp-rosreestr
MCP server for Russian Rosreestr cadastral data: lookup by number, address or coordinates.
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
atomno-mcp-rosreestrclaude mcp add mcp-rosreestr -- uvx atomno-mcp-rosreestr==0.1.6
{
"mcpServers": {
"mcp-rosreestr": {
"command": "uvx",
"args": [
"atomno-mcp-rosreestr==0.1.6"
]
}
}
}
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
المحتويات
mcp-rosreestr
MCP-сервер Росреестра: объект по кадастровому номеру, адресу или координатам, кадастровая стоимость с историей. Только открытые сведения, без данных о собственниках.
Russian cadastral data for AI agents.
Открытые данные Росреестра через НСПД (Национальная система пространственных данных, nspd.gov.ru); Публичная кадастровая карта — запасной источник.
Часть семейства 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
Ссылки
- GitHub
- PyPI
- Issues / баг-трекер
- MCP Catalog (Glama.ai)
- Семейство atomno MCP: atomno-mcp.ru
الأسئلة الشائعة
ما هو mcp-rosreestr؟
MCP server for Russian Rosreestr cadastral data: lookup by number, address or coordinates.
كيف أثبّت mcp-rosreestr؟
يعمل على جهازك. في Claude Code: claude mcp add mcp-rosreestr -- uvx atomno-mcp-rosreestr==0.1.6. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج mcp-rosreestr إلى مفتاح API؟
لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.
هل mcp-rosreestr مفتوح المصدر؟
نعم. شيفرته متاحة على GitHub بترخيص MIT.
من يصون mcp-rosreestr؟
ينشره atomno-mcp. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.