QGIS MCP: плагин для QGIS и подключение к Claude Code, Codex и Cursor

nkarasiak/qgis-mcp· Проверено 12.11.2026· 432на GitHub

Даёт агенту управлять открытым QGIS: загружать слои, править объекты, запускать алгоритмы Processing, оформлять слои, собирать макеты печати и показывать отрисованную карту.

3 реализации:

Плагин из каталога QGIS и сервер через uvx: 125 инструментов, от слоёв и SQL по слоям до макетов, атласа и разработки плагинов; QGIS 3.28–4.x.

Как подключить

Что сделать до подключения

QGIS 3.28 или новее и uv

В QGIS: Plugins → Manage and Install Plugins → найти QGIS MCP → Install, затем перезапустить QGIS

В панели QGIS MCP нажать Start Server: плагин слушает порт 9876

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio qgis \
  -- uvx --from https://github.com/nkarasiak/qgis-mcp/archive/refs/heads/main.zip qgis-mcp-server

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.qgis]
command = "uvx"
args = ["--from", "https://github.com/nkarasiak/qgis-mcp/archive/refs/heads/main.zip", "qgis-mcp-server"]

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "qgis": {
      "command": "uvx",
      "args": [
        "--from",
        "https://github.com/nkarasiak/qgis-mcp/archive/refs/heads/main.zip",
        "qgis-mcp-server"
      ]
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "qgis": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "--from",
        "https://github.com/nkarasiak/qgis-mcp/archive/refs/heads/main.zip",
        "qgis-mcp-server"
      ]
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "qgis": {
      "command": "uvx",
      "args": [
        "--from",
        "https://github.com/nkarasiak/qgis-mcp/archive/refs/heads/main.zip",
        "qgis-mcp-server"
      ]
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "qgis": {
      "command": "uvx",
      "args": [
        "--from",
        "https://github.com/nkarasiak/qgis-mcp/archive/refs/heads/main.zip",
        "qgis-mcp-server"
      ]
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "qgis": {
        "type": "local",
        "command": [
          "uvx",
          "--from",
          "https://github.com/nkarasiak/qgis-mcp/archive/refs/heads/main.zip",
          "qgis-mcp-server"
        ]
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "qgis": {
      "command": "uvx",
      "args": [
        "--from",
        "https://github.com/nkarasiak/qgis-mcp/archive/refs/heads/main.zip",
        "qgis-mcp-server"
      ]
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "qgis": {
      "command": "uvx",
      "args": [
        "--from",
        "https://github.com/nkarasiak/qgis-mcp/archive/refs/heads/main.zip",
        "qgis-mcp-server"
      ]
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

pingпроверяет связь с плагином

get_layersперечисляет слои проекта

add_vector_layerзагружает векторный слой

add_raster_layerзагружает растровый слой

get_layer_featuresчитает объекты слоя

update_featuresправит атрибуты объектов

field_calculatorсчитает поле по выражению

execute_processingзапускает алгоритм Processing

list_processing_algorithmsперечисляет алгоритмы Processing

set_layer_styleзадаёт стиль слоя

set_layer_labelingнастраивает подписи

render_mapотрисовывает карту в картинку

get_canvas_screenshotснимает окно карты

execute_sqlвыполняет SQL по слоям

spatial_joinсоединяет слои по положению

zonal_statisticsсчитает зональную статистику

create_layoutсоздаёт макет печати

export_layoutвыгружает макет в файл

export_layerсохраняет слой в файл

execute_codeвыполняет код PyQGIS

Показано 20 из 125.

Плагин из ZIP сам прописывает сервер в клиент кнопкой Connect / Repair; в контекст грузит 7 базовых инструментов, остальные 100+ ищет по задаче; произвольный Python не выполняет.

Как подключить

Что сделать до подключения

QGIS 3.44 LTR или новее, вплоть до 4.x

Скачать qgis_agent_mcp-*.zip со страницы Releases и поставить: Plugins → Manage and Install Plugins → Install from ZIP

Включить QGIS Agent MCP, нажать Connect an AI client, затем Connect / Repair для своего клиента и перезапустить клиент

Python 3.10 или новее: плагин пишет запускатель ~/.qgis-mcp/bin/qgis_mcp_launcher.py и указывает его в конфиге

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio qgis-mcp \
  -- python3 '<домашняя папка>/.qgis-mcp/bin/qgis_mcp_launcher.py'

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.qgis-mcp]
command = "python3"
args = ["<домашняя папка>/.qgis-mcp/bin/qgis_mcp_launcher.py"]

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "qgis-mcp": {
      "command": "python3",
      "args": ["<домашняя папка>/.qgis-mcp/bin/qgis_mcp_launcher.py"]
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "qgis-mcp": {
      "type": "stdio",
      "command": "python3",
      "args": ["<домашняя папка>/.qgis-mcp/bin/qgis_mcp_launcher.py"]
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "qgis-mcp": {
      "command": "python3",
      "args": ["<домашняя папка>/.qgis-mcp/bin/qgis_mcp_launcher.py"]
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "qgis-mcp": {
      "command": "python3",
      "args": ["<домашняя папка>/.qgis-mcp/bin/qgis_mcp_launcher.py"]
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "qgis-mcp": {
        "type": "local",
        "command": ["python3", "<домашняя папка>/.qgis-mcp/bin/qgis_mcp_launcher.py"]
      }
    }
  }
}

{
  "mcpServers": {
    "qgis-mcp": {
      "command": "python3",
      "args": ["<домашняя папка>/.qgis-mcp/bin/qgis_mcp_launcher.py"]
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "qgis-mcp": {
      "command": "python3",
      "args": ["<домашняя папка>/.qgis-mcp/bin/qgis_mcp_launcher.py"]
    }
  }
}

Инструменты сервера

qgis_contextсобирает контекст проекта под задачу

qgis_toolsищет и включает нужные инструменты

qgis_tool_callвызывает найденный инструмент

qgis_session_snapshotснимает состояние проекта и слоёв

qgis_screenshotснимает окно или карту

qgis_batchвыполняет цепочку шагов за раз

qgis_operationследит за долгой операцией

QGIS Desktop целиком в Docker, ставить QGIS не нужно: 46 инструментов, окно QGIS видно в браузере через noVNC, готовые рецепты и выгрузка в PDF, веб-карту и QField.

Как подключить

Что сделать до подключения

Docker с docker compose

Склонировать репозиторий, скопировать .env.example в .env и выполнить docker compose up -d --build

Проверить, что http://localhost:8100/health отвечает status ok; окно QGIS открывается на http://localhost:6080

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport http qgisremotemcp http://localhost:8100/mcp

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.qgisremotemcp]
url = "http://localhost:8100/mcp"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "qgisremotemcp": {
      "url": "http://localhost:8100/mcp"
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "qgisremotemcp": {
      "type": "http",
      "url": "http://localhost:8100/mcp"
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "qgisremotemcp": {
      "httpUrl": "http://localhost:8100/mcp"
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "qgisremotemcp": {
      "httpUrl": "http://localhost:8100/mcp"
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "qgisremotemcp": {
        "type": "remote",
        "url": "http://localhost:8100/mcp"
      }
    }
  }
}

Customize → Connectors → добавить свой коннектор.
Адрес сервера: http://localhost:8100/mcp

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "qgisremotemcp": {
      "url": "http://localhost:8100/mcp"
    }
  }
}

Инструменты сервера

set_study_zoneзадаёт зону по городу или адресу

smart_loadскачивает данные каталога в GPKG

list_datasourcesпоказывает каталог источников

add_layerдобавляет слой по URI

get_featuresотбирает объекты по фильтрам

run_processingзапускает алгоритм Processing

search_algorithmsищет алгоритм по слову

execute_pythonвыполняет код PyQGIS

get_screenshotснимает окно карты

set_layer_styleзадаёт стиль слоя

run_recipeвыполняет готовый сценарий

export_pdfвыгружает макет в PDF

export_web_mapсобирает веб-карту Leaflet

export_qfieldготовит проект для QField

export_layerсохраняет слой в GPKG, GeoJSON, CSV

execute_asyncставит долгую задачу в фон

upload_fileзагружает файл в контейнер

download_projectсохраняет проект .qgz

Показано 18 из 46.

Что попросить агента

«Проверь связь, создай проект и сохрани его в <путь>.qgz, загрузи слой <файл.gpkg>, оставь объекты со значением <значение> в поле <поле>, отрисуй карту и покажи результат»QGIS MCP вызовет ping, create_new_project, add_vector_layer, затем render_map и save_project

«Проверь этот проект, исправь битые слои, улучши оформление, собери макет печати и посмотри на итоговую карту»QGIS Agent MCP соберёт контекст через qgis_context, найдёт нужные инструменты через qgis_tools, выполнит их qgis_tool_call и проверит результат qgis_screenshot

«Раскрась слой <слой> по полю <поле> и подпиши объекты названием»Агент вызовет set_layer_style с категориями и set_layer_labeling, затем get_canvas_screenshot для проверки

«Собери макет A4 с картой, легендой и масштабной линейкой и выгрузи его в PDF»QGIS MCP вызовет create_layout, add_layout_map, add_layout_legend, add_layout_scalebar и export_layout

«Посчитай среднюю высоту по растру <растр> для каждого полигона слоя <слой>»QGIS MCP вызовет zonal_statistics и покажет поля с результатом через get_layer_features

Для каких задач

Загрузить векторный или растровый слой и отфильтровать объекты по полю

Запустить алгоритм Processing или пакет алгоритмов над слоями проекта

Раскрасить слой по категориям или градиенту и настроить подписи

Собрать макет печати с картой, легендой и масштабной линейкой и выгрузить его

Выполнить SQL-запрос по нескольким слоям сразу

Отрисовать карту и показать агенту картинку для проверки

Ограничения

QGIS MCP и QGIS Agent MCP работают, только пока открыт QGIS с запущенным плагином; версии плагина и сервера QGIS MCP должны совпадать

Сокет QGIS MCP по умолчанию без пароля, а execute_code выполняет любой код PyQGIS: на общей машине задайте QGIS_MCP_TOKEN в QGIS и в env сервера

У QGIS Agent MCP 15 звёзд и последнее обновление в августе 2026, у QgisRemoteMCP 11 звёзд; многопользовательский режим QgisRemoteMCP в бете

Готовые источники данных и рецепты QgisRemoteMCP рассчитаны на Францию: открытые данные IGN, кадастр, DVF

Если не работает

No response from QGIS или connection refused

Проверьте, что QGIS открыт и в панели QGIS MCP горит Server running. Плагин слушает порт 9876; если меняли порт, задайте тот же в QGIS_MCP_PORT.

Список инструментов пуст, при ручном запуске ModuleNotFoundError

uv или uvx не установлен или не виден в PATH. Поставьте uv и проверьте запуск командой uvx --from … qgis-mcp-server.

Агент пишет tool call failed на каждую команду

Сервер запустился, но не достучался до QGIS: запустите плагин. Если задан QGIS_MCP_TOKEN, тот же токен должен стоять в env сервера в конфиге клиента.

После обновления команды падают с ошибкой

Новый сервер шлёт команду, которую старый плагин не знает. Обновите оба и вызовите diagnose, затем нажмите Stop / Start в панели плагина.

Порт 9876 занят другой программой, например аддоном Blender MCP

Запустите QGIS с переменной QGIS_MCP_PORT=9877 и задайте тот же порт в env сервера.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
QGIS MCP	nkarasiak	432	локально	не нужен	125	11 ноября 2026
QGIS Agent MCP	Aaa2122	15	локально	не нужен	7	12 августа 2026
QgisRemoteMCP	nic01asFr (Cerema Méditerranée)	11	HTTP	не нужен	46	3 октября 2026

Частые вопросы

Какой из трёх серверов выбрать?

Для работы в своём QGIS — QGIS MCP: ставится из каталога плагинов и покрывает больше всего задач. QGIS Agent MCP сам настраивает клиента и бережёт контекст. QgisRemoteMCP подходит, если QGIS ставить не хочется: всё крутится в Docker, окно видно в браузере.

125 инструментов съедают контекст, что делать?

Задайте в env сервера QGIS_MCP_TOOL_MODE=compound: инструменты сведутся к 27 групповым, каждая команда остаётся доступной через параметр action. В этом режиме не работает QGIS_MCP_INSTANCES.

Можно управлять несколькими окнами QGIS?

Да, у QGIS MCP: запустите каждое окно с плагином на своём порту и перечислите их в QGIS_MCP_INSTANCES в виде default=9876,planning=9877. Инструменты принимают аргумент instance, list_qgis_instances показывает доступные окна.

Как обновить QGIS MCP?

Плагин обновляется через Manage and Install Plugins, сервер — командой uvx --refresh-package qgis-mcp с тем же --from, после чего перезапустите клиент. Затем вызовите diagnose: он проверит, что версии плагина и сервера совпадают.

Как подключить QGIS MCP к Claude Code?

Поставьте плагин QGIS MCP, нажмите Start Server и выполните claude mcp add -s user qgis -- uvx --from https://github.com/nkarasiak/qgis-mcp/archive/refs/heads/main.zip qgis-mcp-server. Проверка — попросите агента вызвать ping, ответ {"pong": true}.

Как подключить QGIS MCP к Codex?

Команда codex mcp add qgis -- uvx --from https://github.com/nkarasiak/qgis-mcp/archive/refs/heads/main.zip qgis-mcp-server или та же запись в ~/.codex/config.toml в разделе [mcp_servers.qgis]. У QGIS Agent MCP Codex настраивается кнопкой Connect / Repair в плагине.

Где скачать плагин QGIS MCP?

QGIS MCP ставится из каталога плагинов прямо в QGIS: Manage and Install Plugins, поиск по QGIS MCP. QGIS Agent MCP скачивается архивом qgis_agent_mcp-*.zip со страницы Releases репозитория Aaa2122/QGIS-MCP и ставится через Install from ZIP.

Работает ли сервер из России?

Все три сервера работают на вашем компьютере, рядом с QGIS или в Docker, ключи и зарубежные аккаунты не нужны.

QGIS MCP: плагин для QGIS и подключение к Claude Code, Codex и Cursor

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

Частые вопросы

Похожие серверы