Qgis Stream MCP

QgisStreamMCP

QGIS为您的AI助手提供服务 --部署一次，从任何地方使用QGIS。无需本地安装，也不需要GIS专业知识。

在Docker中运行一个完整的QGIS桌面，并将其作为MCP服务器公开。你的人工智能助手有42个工具，涵盖数据加载、空间分析、制图和多格式导出。你不需要安装QGIS——人工智能可以在任何时候从任何设备完全代表你处理它。

管理员只部署一次容器（在服务器、NAS或本地）。用户连接他们的AI客户端，并立即在他们的对话中使用QGIS功能。

亮点

• 无需QGIS --完整的QGIS桌面在Docker中运行。你的人工智能助手代表你使用它——不需要本地安装，也不需要GIS专业知识。
• 随处可用 --在服务器上或本地部署。从任何兼容MCP的AI客户端（克劳德桌面、光标、继续…）连接。
• 智能数据管道 — set_study_zone("Montpellier") 然后 smart_load("bdtopo_batiments").下载WFS作为本地GeoPackage，具有自动分页、R树空间索引、CRS变换功能。处理速度比实时WFS快60-250倍。
• 30+预配置的法语数据集 -BD TOPO，Admin Express，RPG，IGN正射影像，地籍图，DEM，Corine Land Cover，OSM，Esri。无需API密钥。
• 完整的QGIS桌面 --通过noVNC实现实时GUI。AI和用户同时在同一个实例上工作。
• 1000+处理算法 --原住民、GDAL、GRASS、SAGA。所有这些都可以通过MCP工具访问。
• 自动化食谱 --预先构建的工作流程（密度分析、洪水风险、土地覆盖、海岸压力）。一个命令： run_recipe("risque_inondation", zone="Nimes").
• 多格式导出 --PDF布局、交互式传单地图（标准、洪水分析、时间）、QField移动包、Grist协作文档。
• MCP应用程序 --直接嵌入对话中的交互式QGIS视图（VNC查看器、文件上传、键盘/鼠标转发）。

快速开始

git clone https://github.com/nic01asFr/QgisStreamMCP.git
cd QgisStreamMCP
docker compose up -d --build

端点

连接到克劳德桌面

添加 claude_desktop_config.json:

{
  "mcpServers": {
    "qgis": {
      "url": "http://localhost:8100/mcp"
    }
  }
}

智能数据加载

核心创新：一个结构化的管道，用快速的本地GeoPackage文件取代不可靠的实时WFS连接。

为什么？

管道

1. set_study_zone(target="Montpellier")    # Geocode, store bbox, zoom
2. smart_load(id="osm_xyz")                # Basemap (streaming)
3. smart_load(id="bdtopo_batiments")       # Buildings (download GPKG)
4. smart_load(id="bdtopo_routes")          # Roads (download GPKG)
5. get_screenshot                           # Verify
6. run_processing / execute_python          # Analyze
7. export_pdf / export_web_map / ...        # Deliver (PDF, HTML, QField, Grist)

性能（蒙彼利埃，约10公里bbox）

缓存

下载被缓存在 /data/cache/ 使用bbox哈希。相同面积=24小时瞬时重新加载。

可用数据源

所有来源都是免费的（IGN自2021年7月开放数据）。不需要API密钥。

矢量数据（WFS，下载为GPKG）

底图（流媒体）

图像（流媒体）

其他（WMS/neneneba API）

食谱

预构建的工作流模板，可自动完成从数据加载到样式化地图导出的完整分析。

用法

# Automated (all steps in one shot)
run_recipe(id="risque_inondation", zone="Nimes")

# Manual (follow steps one by one)
get_recipe(id="densite_bati", zone="Montpellier")
→ Returns step-by-step instructions to execute individually

导出格式

PDF布局

通过QGIS打印布局和预构建模板（A3横向、A4纵向）打印就绪的PDF。包括标题、图例、比例尺、指北针和数据源。

apply_layout_template(template="a3_landscape", title="Flood Risk — Nimes")
export_pdf(layout="a3_landscape")

交互式网络地图

带有嵌入式GeoJSON数据的传单HTML文件。三个专用模板：

QField移动套餐

便携式ZIP已准备就绪 QField 移动数据收集：

• .qgz 具有相关GPKG来源的项目
• 所有矢量层都具体化为单独的GeoPackages
• 可编辑的 观察 带有表单小部件（下拉菜单、日期选择器、相机、自由文本）的图层

export_qfield(project_name="terrain_survey")
→ /data/terrain_survey_qfield.zip

Grist文件

将QGIS项目层或任何HTML映射转换为 谷物 协作文档(.grist):

• 来自项目 --使用自定义地图小部件将可见矢量图层导出为Grist表格
• 来自HTML --通用转换器：接受任何包含GeoJSON的HTML文件（洪水图、时间图、qgis2web导出），并创建一个Grist文档，其中包含表格中的数据和原始交互式地图作为Grist自定义小部件

检测到的列类型： Choice （彩色下拉菜单）， Date （纪元时间戳）， Ref （交叉表引用）。类似表格的表格会自动获得Grist Form页面。

# From QGIS project
export_grist(title="Urban Analysis")

# From any HTML with GeoJSON
export_grist(html_path="/data/flood_map_nimes.html")

MCP工具

智能加载

核心

数据和图层

样式

食谱

出口

文件

GUI交互

项目

MCP技能（资源）

指导人工智能助手专业知识的参考文件：

MCP提示

MCP应用程序

直接嵌入Claude对话中的交互式QGIS视图：

• 实时VNC查看器 --在对话中查看QGIS并与之互动
• 文件上传 --将文件直接拖放到QGIS容器中
• 键盘/鼠标转发 --无需离开聊天室即可进行全面交互
• MJPEG回退 --轻量级流，提供快速视觉反馈

示例工作流

手册：城市分析

User: "Analyse l'urbanisation autour de Montpellier"

AI: [set_study_zone("Montpellier")]
    → Geocodes, stores bbox, zooms canvas

    [smart_load("osm_xyz")]              → OpenStreetMap basemap
    [smart_load("bdtopo_batiments")]     → 10,000 buildings as GPKG
    [smart_load("bdtopo_routes")]        → 5,000 road segments

    [execute_python → density grid]      → 500m hex grid, graduated symbology
    [apply_layout_template("a3_landscape", title="Densité bâtie — Montpellier")]
    [export_pdf]                         → /data/densite_montpellier.pdf

自动化：配方的洪水风险

User: "Analyse le risque inondation à Nîmes"

AI: [run_recipe("risque_inondation", zone="Nimes")]
    → Executes all steps automatically:
      1. set_study_zone("Nimes")
      2. smart_load basemap + buildings + flood zones
      3. Buffer analysis (50m, 100m, 200m from flood zones)
      4. Building exposure classification
      5. Graduated symbology
    → Returns screenshot + statistics

    [export_flood_map(include_fields=["nature","usage","height"])]
    → Interactive HTML with water height slider

    [export_grist(html_path="/data/flood_map_nimes.html")]
    → Grist document with editable tables + embedded map widget

现场调查：QField Export

User: "Prépare un relevé terrain pour la commune de Sète"

AI: [set_study_zone("Sète")]
    [smart_load("bdtopo_batiments")]
    [smart_load("bdtopo_routes")]
    [set_layer_style("Batiments", type="categorized", field="usage")]

    [export_qfield(project_name="releve_sete")]
    → ZIP with .qgz + GPKGs + Observations layer (camera, dropdowns, date picker)
    → Ready to load on QField mobile app

扩展外部服务

PyQGIS脚本(execute_python)可以调用容器中可访问的任何HTTP服务——本地或远程。这涵盖了ML推理API、自定义后端、卫星处理器、提升服务或任何内部API。

通过环境变量传递服务URL .env:

MY_SERVICE_URL=http://host.docker.internal:8001

然后在脚本中使用它们：

import os, urllib.request, json
url = os.environ.get("MY_SERVICE_URL")
# call your service...

host.docker.internal 解析到主机，允许访问容器外运行的服务。

建筑

┌─────────────────────────────────────────────────────────────┐
│                    QgisStreamMCP Container                      │
│                                                              │
│  supervisord                                                 │
│  ├── Xvfb :99                (virtual display 1920x1080)    │
│  ├── fluxbox                 (window manager)               │
│  ├── QGIS Desktop ◄─────────────────────┐                  │
│  │   └── qgis_bridge.py    (startup)    │ UNIX socket      │
│  ├── x11vnc → noVNC         (:6080)     │                  │
│  ├── api_server.py           (:8080) ───┘                   │
│  ├── main_mcp.py             (:8100) ───┘                   │
│  └── stream_server.py        (:8081)                        │
│                                                              │
│  /data/          (user files, projects)                     │
│  /data/cache/    (smart_load GPKG cache, 24h)               │
│  /app/skills/    (MCP skill documents)                      │
│  /app/datasources.json  (30+ pre-configured sources)        │
└──────────┬──────────────────────────────────────────────────┘
           │ HTTP (optional)
           ▼
    External services     (any HTTP API reachable from the container)

通信流

Claude Desktop / MCP Client
  │ JSON-RPC over Streamable HTTP (:8100)
  ▼
main_mcp.py (MCP Server)
  │ UNIX socket /tmp/qgis_bridge.sock
  ▼
qgis_bridge.py (runs inside QGIS, main thread)
  │ PyQGIS API (iface, QgsProject, processing)
  ▼
QGIS Desktop (Xvfb display :99)
  │ X11
  ▼
x11vnc → websockify → noVNC (:6080)
  │ WebSocket
  ▼
User's browser

发展

# Source files are mounted as volumes — edit locally
# Restart to apply changes:
docker compose restart qgisstreammcp

# View logs
docker compose logs -f qgisstreammcp

# Test API
curl http://localhost:8080/health
curl -X POST http://localhost:8080/api/execute \
  -H "Content-Type: application/json" \
  -d '{"code": "result[\"v\"] = Qgis.version()"}'

# Test smart loading
curl -X POST http://localhost:8080/api/execute \
  -H "Content-Type: application/json" \
  -d '{"code": "result.update(helpers.set_study_zone(\"Montpellier\"))", "timeout": 30}'

项目结构

QgisStreamMCP/
├── main_mcp.py             # MCP Server (40 tools, 10 resources, 3 prompts)
├── datasources.json        # 30+ pre-configured data sources catalog
├── qgis_app.html           # MCP App (interactive QGIS in conversation)
├── src/
│   ├── qgis_bridge.py      # Runs inside QGIS (UNIX socket bridge, 45 actions)
│   ├── qgis_helpers.py     # Python helpers (geocode, smart loading, etc.)
│   ├── api_server.py       # FastAPI REST API
│   └── stream_server.py    # MJPEG stream
├── skills/                 # MCP Resources (AI skill documents)
│   ├── smart_loading.md
│   ├── pyqgis.md
│   ├── processing.md
│   ├── cartography.md
│   ├── helpers.md
│   ├── data_sources.md
│   └── external_services.md
├── recipes/                # Workflow recipes (JSON)
│   ├── densite_bati.json
│   ├── urbanisme_general.json
│   ├── risque_inondation.json
│   ├── occupation_sol.json
│   └── pression_fonciere_cotiere.json
├── templates/              # Print layout templates (.qpt)
│   ├── a3_landscape.qpt
│   ├── a4_portrait.qpt
│   └── web/                # Leaflet HTML templates
│       ├── leaflet_template.html
│       ├── leaflet_flood_template.html
│       └── leaflet_temporal_template.html
├── projects/               # QGIS project files (persisted)
├── docs/                   # Architecture diagrams
├── Dockerfile
├── docker-compose.yml
├── supervisord.conf
├── entrypoint.sh
├── requirements.txt
└── CLAUDE.md

许可证

麻省理工学院

积分

• QGIS — https://qgis.org
• 无VNC — https://novnc.com
• 主控程序 — https://modelcontextprotocol.io
• IGN地球板块 — https://data.geopf.fr（免费法国国家地理数据）
• GDAL/OGR — https://gdal.org（数据转换和下载引擎）