QGISMCP - QGIS Model Context Protocol Integration

基本能力

产品定位

QGISMCP是一个连接QGIS和Claude AI的桥梁，通过MCP协议实现双向通信，使得AI可以直接操作QGIS进行地理信息系统的相关操作。

核心功能

• 双向通信：通过基于套接字的服务器连接Claude AI和QGIS。
• 项目操作：创建、加载和保存QGIS项目。
• 图层操作：添加和移除矢量或栅格图层。
• 执行处理：执行QGIS的处理算法（Processing Toolbox）。
• 代码执行：从Claude运行任意Python代码在QGIS中。

适用场景

• 自动化GIS项目创建和管理。
• 通过AI辅助进行地理数据处理和分析。
• 快速生成地图和可视化效果。

工具列表

• ping：检查服务器连接。
• get_qgis_info：获取当前QGIS安装信息。
• load_project：从指定路径加载QGIS项目。
• create_new_project：创建新项目并保存。
• get_project_info：获取当前项目信息。
• add_vector_layer：添加矢量图层到项目。
• add_raster_layer：添加栅格图层到项目。
• get_layers：检索当前项目中的所有图层。
• remove_layer：通过ID移除图层。
• zoom_to_layer：缩放到指定图层的范围。
• get_layer_features：从矢量图层检索特征。
• execute_processing：执行带有给定参数的处理算法。
• save_project：保存当前项目到指定路径。
• render_map：将当前地图视图渲染为图像文件。
• execute_code：执行提供的PyQGIS代码字符串。

常见问题解答

• 如果在Claude中找不到“Developers”选项卡或claude_desktop_config.json文件，请参考文档。

使用教程

使用依赖

• QGIS 3.X（仅在3.22上测试过）。
• 云桌面。
• Python 3.10或更新版本。
• uv包管理器。

安装uv

在Mac上：

brew install uv

在Windows Powershell上：

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

其他平台的安装指南请参考uv安装文档。

安装教程

1. 克隆仓库：

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

1. 将qgis_mcp_plugin文件夹及其内容复制到QGIS配置文件的插件文件夹中。
2. Windows路径示例：C:\Users\USER\AppData\Roaming\QGIS\QGIS3\profiles\default\python\plugins
3. MacOS路径示例：~/Library/Application\ Support/QGIS/QGIS3/profiles/default/python/plugins
4. 重新启动QGIS，在Plugins -> Installing and Managing Plugins中启用“QGIS MCP”插件。
5. 在Claude的Settings -> Developer -> Edit Config -> claude_desktop_config.json中添加配置。

调试方式

1. 在QGIS中，转到plugins -> QGIS MCP -> QGIS MCP。
2. 点击“Start Server”启动服务器。
3. 在Claude中，使用提供的工具进行交互和调试。

许可证

None