
    ==================
      
       /// MCP ///
      /// QGI ///
        
    ==================
        
    [server:online]
    [protocol:ready]

qgis_mcp

by jjsantos01

Model Context Protocol (MCP) server + QGIS plugin that lets LLMs (e.g. Claude) control a local QGIS Desktop session

573

Specialized

Installation

1. Install QGIS Desktop (v3.30 or newer recommended).

2. Install Python ≥3.9 (QGIS bundles its own Python but an external interpreter is useful for development).

3. Clone the repository:

git clone https://github.com/jjsantos01/qgis_mcp.git && cd qgis_mcp

4. (Optional) Create a virtual-environment and activate it:

python -m venv .venv
source .venv/bin/activate   # Windows: .venv\Scripts\activate

5. Install Python requirements:

pip install -r requirements.txt

6. Launch the MCP server:

python mcp_server.py --port 3333 # adjust script/port if README differs

7. Open QGIS and enable the “Python Console” or the included QGIS plugin (if provided) so that MCP can issue commands to the running QGIS instance.

8. Expose the service (optional):

# behind a reverse proxy
ssh -R 0.0.0.0:3333:localhost:3333 your-box

9. Test with curl or an LLM agent configured for Model Context Protocol:

curl http://localhost:3333/health

License: Unknown – no license metadata present in the repository record

Updated 7/30/2025