nspd-mcp

Экспериментальный прототип MCP-сервера для ФГИС «Единая цифровая платформа «Национальная система пространственных данных» (НСПД).

Предоставляет AI-агентам (через Model Context Protocol) инструменты для поиска и получения сведений об объектах недвижимости: земельных участках, зданиях, сооружениях, кадастровых кварталах и других пространственных данных.

НЕ для промышленного использования. Данные могут быть неполными, устаревшими или временно недоступными.

Возможности

• Поиск объектов по кадастровому номеру или текстовому запросу
• Пространственный поиск — по координатам (lat/lng) и в полигоне (GeoJSON)
• Детальная информация — части ЗУ, виды разрешённого использования, связанные объекты
• Ресурсы — список слоёв, данные объекта по кадастровому номеру, health-check
• Промпты — анализ земельного участка, сравнение объектов
• Три транспорта — stdio, SSE, HTTP

Установка

Из исходного кода

pip install nspd-mcp

Через Docker

docker build -t nspd-mcp .
docker run -i --rm nspd-mcp                             # stdio
docker run --rm -p 8000:8000 nspd-mcp --transport http  # http

Использование

# stdio (по умолчанию, для десктопных агентов)
nspd-mcp

# SSE (для веб-интерфейсов)
nspd-mcp --transport sse --port 8000

# HTTP (для облачных развёртываний)
nspd-mcp --transport http --port 8000

Настройка

Все параметры задаются переменными окружения с префиксом PYNSPD_:

Инструменты MCP

Ресурсы MCP

Промпты

Разработка

pip install -e ".[dev]"
ruff check src/          # линтинг
pytest tests/unit -v     # unit-тесты
pytest -v                # все тесты

Интеграционные тесты требуют доступа к API НСПД (включить NSPD_INTEGRATION_TESTS=1).

Архитектура

• FastMCP — фреймворк MCP-сервера
• pynspd — неофициальная библиотека для API НСПД
• hishel — HTTP-кэш (TTL 24ч для объектов, 7д stale-запас)
• src-layout на hatchling

Слои НСПД имеют русские названия (например, "Земельные участки из ЕГРН", "Здания", "Кадастровые кварталы"). Для получения полного списка используйте ресурс nspd://layers.

Лицензия

MIT