QGIS MCP Server
by Bytes-007
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| QGIS_MCP_HOST | No | Host for the socket connection to the QGIS plugin. | localhost |
| QGIS_MCP_PORT | No | Port for the socket connection. The QGIS plugin reads it too: set in the environment QGIS is launched from, it overrides the port saved in the plugin's dropdown for that window. | 9876 |
| QGIS_MCP_TOKEN | No | Optional shared secret. When set (in both the QGIS environment and the MCP server environment), the plugin rejects any command without a matching token. Required when the plugin binds to a non-loopback address. | |
| QGIS_MCP_LOG_FILE | No | Log file path (empty to disable). | ~/.local/share/qgis-mcp/server.log |
| QGIS_MCP_INSTANCES | No | Address several running QGIS windows from one server, as comma-separated `name=port` or `name=host:port` entries (e.g. "default=9876,planning=9877,archive=lab-box:9878"). Unset by default. Not supported with QGIS_MCP_TOOL_MODE=compound. | |
| QGIS_MCP_LOG_LEVEL | No | File log level. | INFO |
| QGIS_MCP_TOOL_MODE | No | `granular` (125 tools) or `compound` (27 grouped tools). Compound mode reduces schema overhead but loses `instance=`, typed parameters and per-tool annotations. | granular |
| QGIS_MCP_TRANSPORT | No | MCP transport: `stdio` or `streamable-http`. | stdio |
| QGIS_MCP_AUTO_CONFIRM | No | Confirmation elicitation on destructive tools is skipped by default, since clients already ask before running them. Set to `0`/`false`/`no`/`off` to elicit anyway - worth it only for a client that runs tools unattended. | on |
| QGIS_MCP_TOOL_PROFILE | No | `all` (125 tools), `read-only` (44 tools) or `core` (24 tools): a subset of the granular tools, keeping typed parameters and annotations. Combining a profile with QGIS_MCP_TOOL_MODE=compound is refused. | all |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Server capabilities have not been inspected yet.
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
No tools | |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
This server cannot be deployed
Maintenance
ActivityActive
ResponsivenessNo issues