jjsantos01/qgis_mcp

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

1.1천 stars 190 forks 품질 50 트렌드 25

Repository Install

LLM이 QGIS 데스크톱을 사용할 수 있도록 하는 모델 컨텍스트 프로토콜(MCP)

개요

QGISMCP는 모델 컨텍스트 프로토콜(MCP)을 통해 QGIS와 Claude AI를 연결하여 Claude가 QGIS와 직접 상호작용하고 제어할 수 있게 합니다. 이 통합은 프로젝트 생성 지원, 레이어 로딩, 코드 실행 등 다양한 기능을 가능하게 합니다. 이 프로젝트는 시드하르트 아후자의 BlenderMCP 프로젝트를 강하게 기반으로 하고 있습니다 - : Claude AI를 소켓 기반 서버를 통해 QGIS에 연결. - : QGIS에서 프로젝트를 생성, 불러오고 저장합니다. - : 프로젝트에 벡터 또는 래스터 레이어를 추가하거나 제거합니다. - : 처리 알고리즘(Processing Toolbox)을 실행합니다. - : Claude에서 QGIS로 임의의 Python 코드를 실행합니다. 매우 강력하지만 이 도구를 사용할 때는 매우 조심해야 합니다. 이 시스템은 두 가지 주요 구성 요소로 구성되어 있습니다: 1. : QGIS 내에서 명령을 수신하고 실행할 소켓 서버를 생성하는 QGIS 플러그인. 2. : 모델 컨텍스트 프로토콜을 구현하고 QGIS 플러그인에 연결하는 파이썬 서버. - QGIS 3.X (3.22에서만 테스트됨) - Claude 데스크탑 - Python 3.

개요(AI 번역)

QGISMCP는 모델 컨텍스트 프로토콜(MCP)을 통해 QGIS와 Claude AI를 연결하여 Claude가 QGIS와 직접 상호작용하고 제어할 수 있게 합니다. 이 통합은 프로젝트 생성 지원, 레이어 로딩, 코드 실행 등 다양한 기능을 가능하게 합니다.

이 프로젝트는 시드하르트 아후자의 BlenderMCP 프로젝트를 강하게 기반으로 하고 있습니다

특징

양방향 통신: Claude AI를 소켓 기반 서버를 통해 QGIS에 연결합니다.
프로젝트 조작: QGIS에서 프로젝트를 생성, 불러오고 저장합니다.
레이어 조작: 프로젝트에 벡터 또는 래스터 레이어를 추가하거나 제거합니다.
실행 처리: 실행 처리 알고리즘 (Processing Toolbox).
코드 실행: Claude에서 QGIS로 임의의 Python 코드를 실행하세요. 매우 강력하지만 이 도구를 사용할 때는 매우 조심해야 합니다.

구성 요소

이 시스템은 두 가지 주요 구성 요소로 구성되어 있습니다:

QGIS 플러그인: QGIS 내에서 명령을 수신하고 실행하는 소켓 서버를 생성하는 QGIS 플러그인입니다.
MCP 서버: 모델 컨텍스트 프로토콜을 구현하고 QGIS 플러그인에 연결하는 파이썬 서버입니다.

설치

전제 조건

QGIS 3.X (3.22에서만 테스트됨)
클로드 데스크톱
파이썬 3.10 또는 그 이후의 버전
UV 패키지 관리자:

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

README

원문 README의 일부입니다. 원문 보기.

QGISMCP - QGIS Model Context Protocol Integration

QGISMCP connects QGIS to Claude AI through the Model Context Protocol (MCP), allowing Claude to directly interact with and control QGIS. This integration enables prompt assisted project creation, layer loading, code execution and more.

This project is strongly based on the BlenderMCP project by Siddharth Ahuja

Features

Two-way communication: Connect Claude AI to QGIS through a socket-based server.
Project manipulation: Create, load and save projects in QGIS.
Layer manipulation: Add and remove vector or raster layers to a project.
Execute processing: Execute processing algorithms (Processing Toolbox).
Code execution: Run arbitrary Python code in QGIS from Claude. Very powerful, but also be very cautious using this tool.

Components

The system consists of two main components:

QGIS plugin: A QGIS plugin that creates a socket server within QGIS to receive and execute commands.
MCP Server: A Python server that implements the Model Context Protocol and connects to the QGIS plugin.

Installation

Prerequisites

QGIS 3.X (only tested on 3.22)
Claude desktop
Python 3.10 or newer
uv package manager:

If you’re on Mac, please install uv as

brew install uv

On Windows Powershell

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Otherwise installation instructions are on their website: Install uv

⚠️ Do not proceed before installing UV

Download code

Download this repo to your computer. You can clone it with:

git clone [email protected]:jjsantos01/qgis_mcp.git

QGIS plugin

You need to copy the folder qgis_mcp_plugin and its content on your QGIS profile plugins folder.

You can get your profile folder in QGIS going to menu Settings -> User profiles -> Open active profile folder Then, go to Python/plugins and paste the folder qgis_mcp_plugin.

On a Windows machine the plugins folder is usually located at: C:\Users\USER\AppData\Roaming\QGIS\QGIS3\profiles\default\python\plugins

and on MacOS: ~/Library/Application\ Support/QGIS/QGIS3/profiles/default/python/plugins

Then close QGIS and open it again. Go to the menu option Plugins > Installing and Managing Plugins, select the All tab and search for “QGIS MCP”, then mark the QGIS MCP checkbox.

Claude for Desktop Integration

Go to Claude > Settings > Developer > Edit Config > claude_desktop_config.json to include the following:

GitHub에서 전체 README 보기

설치

This server does not publish a one-line install command.

Open the repository installation guide MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{
    "mcpServers": {
        "qgis": {
            "command": "uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/PARENT/REPO/FOLDER/qgis_mcp/src/qgis_mcp",
                "run",
                "qgis_mcp_server.py"
            ]
        }

    }
}