QGIS·jjsantos01
QGIS MCP — подключение и инструкция
QGIS MCP соединяет ИИ-агента с QGIS для исследования проекта, загрузки слоёв и выполнения поддерживаемых GIS-операций.
Что умеет этот сервер
QGIS MCP соединяет ИИ-агента с QGIS для исследования проекта, загрузки слоёв и выполнения поддерживаемых GIS-операций.
Community-интеграция состоит из MCP-процесса и QGIS plugin.
Открой копию GIS-проекта, прочитай список слоёв и системы координат.
Задача для знакомства
Через QGIS MCP прочитай список слоёв тестового проекта и их CRS. Файлы, геометрию и атрибуты не меняй.
Уточнить результат
Сверь активный профиль QGIS, плагин, пути файлов и CRS. Слой вне видимой области не обязательно означает ошибку загрузки.
Как подключить
Выберите подходящий способПодключить QGIS MCP
Скачай проект и скопируй qgis_mcp_plugin в Python/plugins активного профиля QGIS. Перезапусти QGIS и включи плагин. В MCP-клиенте настрой uv с абсолютным каталогом src/qgis_mcp и запуском qgis_mcp_server.py по README.
Что понадобится
- QGIS 3.x, Python 3.10+, uv и доступ к тестовым геоданным.
- 01
Подготовь окружение
QGIS 3.x, Python 3.10+, uv и доступ к тестовым геоданным.
- 02
Установи и настрой
Скачай проект и скопируй qgis_mcp_plugin в Python/plugins активного профиля QGIS. Перезапусти QGIS и включи плагин. В MCP-клиенте настрой uv с абсолютным каталогом src/qgis_mcp и запуском qgis_mcp_server.py по README.
- 03
Открой новую сессию
Убедись, что клиент видит инструменты именно этого сервера, и выполни первый небольшой сценарий.
Пример MCP-конфигурации на основе README
{
"mcpServers": {
"qgis": {
"command": "uv",
"args": [
"--directory",
"/ABSOLUTE/PATH/TO/PARENT/REPO/FOLDER/qgis_mcp/src/qgis_mcp",
"run",
"qgis_mcp_server.py"
]
}
}
}Первый запрос — пример для чата агента
Через QGIS MCP прочитай список слоёв тестового проекта и их CRS. Файлы, геометрию и атрибуты не меняй.Как проверить
Сверь активный профиль QGIS, плагин, пути файлов и CRS. Слой вне видимой области не обязательно означает ошибку загрузки.
Подставь собственные пути, адреса и доступы только в локальные настройки. Команды запуска, MCP-конфигурация и текст первого запроса вводятся в разных местах; их назначение указано над примером.
README и установка автораЧто умеет QGIS
QGIS MCP соединяет ИИ-агента с QGIS для исследования проекта, загрузки слоёв и выполнения поддерживаемых GIS-операций.
Community-интеграция состоит из MCP-процесса и QGIS plugin. В README указано тестирование на QGIS 3.22; другие версии требуют проверки.
Что подготовить перед подключением
QGIS 3.x, Python 3.10+, uv и доступ к тестовым геоданным.
Как установить и подключить
Скачай проект и скопируй qgis_mcp_plugin в Python/plugins активного профиля QGIS. Перезапусти QGIS и включи плагин. В MCP-клиенте настрой uv с абсолютным каталогом src/qgis_mcp и запуском qgis_mcp_server.py по README.
Добавь выбранную запись в существующую конфигурацию клиента, сохранив остальные серверы. Формат и расположение настроек зависят от клиента: JSON-пример для Claude Desktop не нужно целиком вставлять в TOML-файл другого приложения. После изменения перечитай конфигурацию или открой новую сессию.
Как пользоваться: первый сценарий
Открой копию GIS-проекта, прочитай список слоёв и системы координат. Загрузи один тестовый слой и проверь его extent, CRS и атрибуты перед анализом.
Как проверить результат и решить проблемы
Сверь активный профиль QGIS, плагин, пути файлов и CRS. Слой вне видимой области не обязательно означает ошибку загрузки.
Если инструмент не появился, проверь запуск процесса или доступность endpoint, журнал клиента и права доступа. Если соединение есть, но операция не выполняется, сверяй входные параметры и ограничения сервиса; повторять изменяющий запрос без проверки результата не стоит.
Ограничения
Выполнение кода и обработка геоданных могут изменять файлы. Совместимость плагина и библиотек QGIS не следует из одной успешной установки uv.
Исходники и документация
Репозиторий: jjsantos01/qgis_mcp. В README доступны актуальные варианты установки, требования и примеры настройки. Перед обновлением сохрани рабочую конфигурацию и проверь изменения версии.
Другие подключения — в каталоге MCP-серверов Нейролюба.