Cursor+QGIS-MCP：AI代码编辑器下的插件复现实战

1. 从零开始Cursor编辑器与QGIS-MCP插件复现指南最近在折腾QGIS的MCP插件时发现很多朋友卡在了环境配置这一步。传统的Claude方案在国内确实不太友好我摸索出一套用Cursor编辑器完整复现的流程实测下来比原方案更稳定。下面就把我的踩坑经验和完整操作步骤分享给大家。Cursor作为新一代AI代码编辑器最大的优势是内置了智能补全和代码理解能力。我在配置过程中发现它的环境管理特别顺手尤其是对Python依赖的处理比传统方式简洁很多。整个流程从安装到测试大概需要30分钟对新手也很友好。2. 环境准备Cursor编辑器安装与配置2.1 安装Cursor编辑器首先到Cursor官网下载最新版本当前稳定版是0.46。安装过程非常简单Windows用户直接双击exe文件Mac用户拖拽到Applications文件夹即可。我建议安装时勾选添加到PATH选项这样后面在命令行调用会更方便。安装完成后首次启动会有一个初始化配置向导。这里有个小技巧在AI功能设置页面建议开启自动补全和代码理解两个核心功能这对后续的插件开发非常有帮助。如果遇到网络连接问题可以尝试切换不同的网络环境。2.2 配置Python环境Cursor自带Python环境管理功能比手动配置方便很多。打开编辑器后按CtrlShiftP调出命令面板输入Python: Create Environment选择UV作为包管理工具这是Cursor推荐的轻量级方案配置完成后在终端输入以下命令验证python --version uv --version如果看到Python 3.x和uv版本号输出说明环境已经就绪。我遇到过uv命令找不到的情况这时候需要手动添加环境变量把Cursor安装目录下的bin文件夹路径加到系统PATH中。3. 获取QGIS-MCP插件源码3.1 克隆代码仓库在Cursor中新建终端Terminal - New Terminal执行git clone gitgithub.com:jjsantos01/qgis_mcp.git cd qgis_mcp如果Git报权限错误可以换成HTTPS方式克隆git clone https://github.com/jjsantos01/qgis_mcp.git3.2 代码结构解析克隆下来的项目主要包含这些关键部分/src/qgis_mcp: 插件核心代码/docs: 文档和说明/examples: 示例数据特别要注意的是qgis_mcp_plugin文件夹这就是待会要安装到QGIS的插件主体。我建议先用Cursor浏览一遍代码结构它的文件树视图比普通编辑器更直观还能显示每个文件的修改状态。4. 插件安装与依赖管理4.1 部署到QGIS插件目录找到你的QGIS配置路径通常位于C:\Users\[用户名]\AppData\Roaming\QGIS\QGIS3\profiles\default\python\plugins把克隆项目中src/qgis_mcp/qgis_mcp_plugin整个文件夹复制到这里。有个常见坑点一定要确保文件夹命名一致我见过有人复制时多加了空格导致插件加载失败。4.2 安装Python依赖在Cursor终端中导航到插件目录cd src/qgis_mcp然后用uv安装依赖uv install -r requirements.txt这里有个实用技巧如果遇到某个包安装失败可以尝试单独安装它。比如我遇到过numpy版本冲突用这个命令解决uv install numpy1.21.05. 运行测试与问题排查5.1 启动插件服务在Cursor中直接运行主程序uv --directory src/qgis_mcp run qgis_mcp_server.py正常会看到服务启动日志。如果报错最常见的两种情况端口冲突修改代码中的端口号依赖缺失检查是否所有requirements.txt中的包都安装成功5.2 QGIS中的配置打开QGIS在菜单栏选择插件-管理和安装插件在已安装选项卡中找到MCP插件并启用。第一次使用时需要配置服务地址默认是http://localhost:5000。我在测试时发现插件有时不会立即出现在列表里这时可以尝试重启QGIS检查插件目录权限查看QGIS启动日志帮助-切换调试模式6. 实际应用案例演示现在我们来创建一个简单的工程测试插件功能。在QGIS中加载一些示例点数据可以在examples文件夹找到打开MCP插件面板设置参数并运行计算计算完成后会生成最小凸多边形结果。有个实用技巧如果结果不符合预期可以调整缓冲距离参数这个对边缘效果影响很大。我在处理城市边界数据时发现设置300米缓冲能得到最合理的多边形。Cursor的另一个优势是调试方便。在运行过程中如果遇到Python错误可以直接在编辑器中设置断点调试。比传统QGIS插件开发需要反复重启的方式高效很多。