Overview of MCP Server for QGIS

The MCP Server for QGIS, an updated version from the qgis_mcp repository, is a groundbreaking integration that connects QGIS with Claude AI through the Model Context Protocol (MCP). This powerful combination allows for two-way communication, enabling Claude AI to directly interact with and control QGIS. This integration provides a robust platform for prompt-assisted project creation, layer loading, code execution, and more.

Use Cases

1. Geospatial Project Management: The MCP Server facilitates seamless project manipulation, allowing users to create, load, and save projects within QGIS efficiently. This is particularly useful for large-scale geospatial projects that require dynamic data manipulation and visualization.

2. Data Layer Management: Users can easily add or remove vector and raster layers to projects, making it ideal for projects requiring complex data visualization and analysis.

3. Automated Geoprocessing: By executing processing algorithms from the QGIS Processing Toolbox, users can automate repetitive geoprocessing tasks, enhancing productivity and accuracy.

4. Custom Code Execution: The ability to run arbitrary Python code within QGIS from Claude AI provides unparalleled flexibility for custom geospatial analysis and map rendering.

Key Features

• Two-way Communication: Establishes a socket-based server connection between Claude AI and QGIS, enabling real-time data exchange and command execution.
• Project Manipulation: Offers comprehensive tools for creating, loading, and saving QGIS projects, enhancing project management capabilities.
• Layer Manipulation: Supports the addition and removal of vector or raster layers, crucial for detailed geospatial analysis.
• Execute Processing: Leverages the QGIS Processing Toolbox to execute complex geoprocessing algorithms efficiently.
• Code Execution: Executes arbitrary Python code, providing extensive customization and automation capabilities within QGIS.

Components

The system comprises two main components:

1. QGIS Plugin: A plugin that sets up a socket server within QGIS to handle and execute commands.
2. MCP Server: A Python server that implements the Model Context Protocol, connecting to the QGIS plugin.

Installation

Prerequisites

• QGIS 3.X: Tested on versions 3.22 and 3.34.
• Cloud Desktop: Required for optimal performance.
• Python 3.10 or newer: Essential for running the server.
• UV Package Manager: Necessary for installing dependencies.

Installation Steps

1. Download Code: Clone the repository from GitHub to your local machine.
2. QGIS Plugin Installation: Copy the qgis_mcp_plugin folder to your QGIS profile plugins folder.
3. Claude Integration: Modify the claude_desktop_config.json to include the MCP server configuration.

Usage

Starting the Connection

1. Access the QGIS MCP plugin from the QGIS plugins menu.
2. Click “Start Server” to initiate the connection.

Using with Claude AI

Once configured, Claude AI provides a suite of tools for interacting with QGIS, including commands for loading projects, adding layers, executing processing algorithms, and more.

Example Commands

The server supports a variety of commands for interacting with QGIS, such as:

• Ping: Check server connectivity.
• Load Project: Load a specified QGIS project.
• Add Vector Layer: Add a vector layer to the project.
• Execute Processing: Run a processing algorithm with specified parameters.

UBOS Platform Integration

The MCP Server for QGIS is part of the broader UBOS platform, a full-stack AI Agent Development Platform. UBOS is dedicated to integrating AI Agents into every business department, providing tools to orchestrate AI Agents, connect with enterprise data, and build custom AI Agents using LLM models and Multi-Agent Systems. This integration enhances the capabilities of QGIS, making it a powerful tool for businesses looking to leverage AI in geospatial analysis.

In summary, the MCP Server for QGIS is an innovative solution that bridges the gap between AI and geospatial analysis, providing users with advanced tools for project management, data manipulation, and automation. Whether you’re a geospatial analyst, a data scientist, or a business looking to integrate AI into your workflow, the MCP Server offers unparalleled capabilities to enhance your projects.