QGIS를 모델 컨텍스트 프로토콜(MCP)을 사용하는 모든 AI 에이전트에 연결하면, 에이전트가 QGIS를 직접 구동할 수 있습니다: 레이어 관리, 피처 편집, 처리 알고리즘 실행, 맵 렌더링 등.

레이어 관리, 피처 편집, 처리, 렌더링, 스타일링, 레이아웃 및 아틀라스 작성, 크로스레이어 SQL, 플러그인 개발, 시스템 관리를 포함하는 125개의 MCP 도구. QGIS 3.28–4.x와 호환됩니다. 모델 및 클라이언트에 구애받지 않으며, Claude Code, Codex CLI, Gemini CLI, Qwen Code, Kimi Code CLI, GitHub Copilot CLI, opencode, LM Studio, Claude Desktop, Cursor, VS Code, Windsurf, Zed 등 모든 MCP 클라이언트가 작동합니다.

건축

1. QGIS 플러그인 (qgis_mcp_plugin/) - QGIS 내부에서 실행됩니다. QGIS 이벤트 루프 내에서 JSON 명령을 처리하는 차단 없는 TCP 소켓 서버입니다.
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 도크 위젯에서 서버 시작을 클릭하세요.

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