将QGIS连接到任何使用模型上下文协议（MCP）的AI代理，使代理直接驱动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 等。

建筑

1. QGIS插件（qgis_mcp_plugin/）——运行在QGIS内部。非阻塞的TCP套接字服务器，在QGIS事件循环中处理JSON命令。
2. MCP 服务器（src/qgis_mcp/server.py）——运行于QGIS外部。通过FastMCP将QGIS操作暴露为MCP工具。

安装

不需要克隆。需要QGIS 3.28+和UV。

1.安装QGIS插件

在QGIS中：Plugins > Manage and Install Plugins >搜索 QGIS MCP >安装。

重启 QGIS，并在 QGIS MCP dock 控件中点击 Start Server。

2.连接你的编码代理

克劳德密码

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

1. QGIS Plugin (qgis_mcp_plugin/) - Runs inside QGIS. Non-blocking TCP socket server that processes JSON commands within QGIS’s event loop.
2. 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