nkarasiak/qgis-mcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

402 stars 88 forks Качество 88 Тренд 37GPL-2.0

Repository Install

nkarasiak/qgis-mcp — это кандидат на MCP-сервер, импортированный из https://github.com/nkarasiak/qgis-mcp.

Обзор

nkarasiak/qgis-mcp — это кандидат на MCP-сервер, импортированный из https://github.com/nkarasiak/qgis-mcp.

Обзор (машинный перевод)

Подключите QGIS к любому агенту ИИ, который говорит на протоколе Model Context Protocol (MCP), чтобы агент управлял QGIS напрямую: управлял слоями, редактировал функции, запускал алгоритмы обработки, отображал карты и многое другое.

125 MCP-инструментов, охватывающих управление слоями, редактирование функций, обработку, рендеринг, стилизацию, создание макета и атласа, кросс-слойное SQL, разработку плагинов и управление системами. Совместимо с QGIS 3.28–4.x. Независимо от модели и клиента: работает любой клиент MCP, среди них Claude Code, Codex CLI, Gemini CLI, Qwen Code, Kimi Code CLI, GitHub Copilot CLI, opencode, LM Studio, Claude Desktop, Cursor, VS Code, Windsurf, Zed и другие.

Архитектура

QGIS Plugin (qgis_mcp_plugin/) — работает внутри QGIS. Неблокирующий сервер TCP-сокетов, который обрабатывает JSON-команды в цикле событий QGIS.
MCP Server (src/qgis_mcp/server.py) — работает вне QGIS. Показывает операции QGIS как инструменты MCP через FastMCP.

Установка

Клон не нужен. Требуется QGIS 3.28+ и UV.

1. Установите плагин QGIS

В QGIS: Plugins > Manage and Install Plugins > поиск QGIS MCP > Install.

Перезапустите QGIS и нажмите Запустить сервер в виджете QGIS MCP dock.

2. Подключите свой кодировщик

Код Клода

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

QGIS MCP

Connect QGIS to any AI agent that speaks the Model Context Protocol (MCP), so the agent drives QGIS directly: manage layers, edit features, run processing algorithms, render maps, and more.

125 MCP tools covering layer management, feature editing, processing, rendering, styling, layout & atlas authoring, cross-layer SQL, plugin development, and system management. Compatible with QGIS 3.28–4.x. Model and client agnostic: any MCP client works, among them Claude Code, Codex CLI, Gemini CLI, Qwen Code, Kimi Code CLI, GitHub Copilot CLI, opencode, LM Studio, Claude Desktop, Cursor, VS Code, Windsurf, Zed, and more.

Architecture

AI agent ←→ MCP Server (FastMCP) ←→ TCP socket ←→ QGIS Plugin (QTimer) ←→ PyQGIS API

QGIS Plugin (qgis_mcp_plugin/) - Runs inside QGIS. Non-blocking TCP socket server that processes JSON commands within QGIS’s event loop.
MCP Server (src/qgis_mcp/server.py) - Runs outside QGIS. Exposes QGIS operations as MCP tools via FastMCP.

Installation

No clone needed. Requires QGIS 3.28+ and uv.

1. Install the QGIS plugin

In QGIS: Plugins > Manage and Install Plugins > search QGIS MCP > Install.

Restart QGIS and click Start Server in the QGIS MCP dock widget.

2. Connect your coding agent

Открыть полный README на GitHub

Установка

uvx --from https://github.com/nkarasiak/qgis-mcp/archive/refs/heads/main.zip qgis-mcp-server

Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

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