MCP保姆级教程：扣子空间实操，小白入门必备！

<think>首先，用户的问题是关于在QGIS中安装
MCP插件的详细
教程。我需要基于提供的引用材料来回答。 回顾引用： – 引用[1]：涉及QGIS Server的安装，强调安装路径不要有空格。 – 引用[2]：描述了如何安装qgis_
mcp插件通过ZIP文件。 – 引用[3]：详细说明了如何手动复制插件文件夹、修改端口号（从9876到9880），并配置
MCP服务器。 – 引用[4]：提到uv工具，一个Python包管理工具，用于安装uv。 用户的问题是：“我想获取在QGIS中安装
MCP的详细
教程 请问QGIS安装
MCP的详细
教程”。所以，焦点是安装
MCP插件。 从引用中提取关键步骤： 1. 下载插件：[^2]提到从ZIP文件安装插件。具体步骤：打开QGIS -> Plugins -> Manage and Install Plugins -> Install from ZIP。 2. 手动复制插件：[^3]描述了一种方法：克隆项目并复制qgis_
mcp_plugin文件夹到QGIS的python-plugins目录。 3. 修改端口号：[^3]强调修改端口号为9880（或其他），以避免冲突。需要修改两个文件：qgis_
mcp_plugin.py和qgis_
mcp_server.py。 4. 配置
MCP服务器：[^3]提到使用windsurf工具配置
MCP服务器，提供一个JSON配置示例。 5. 安装uv工具：[^4]提到使用Powershell命令安装uv。 我的回答需要结构化、清晰，逐步指导用户。既然用户指定了“详细
教程”，我应该提供一个完整的指南。 结构化回答： 1. 引言：简要介绍
MCP是什么（如果可能），但引用中没有定义。假设用户知道它是QGIS的一个插件。 2. 安装插件： – 方法1：通过ZIP文件安装（来自[^2]）。 – 方法2：手动复制插件文件夹（来自[^3]）。 3. 配置端口：修改端口号以避免冲突（来自[^3]）。 4. 配置
MCP服务器：使用windsurf设置JSON配置（来自[^3]）。 5. 安装依赖：安装uv工具（来自[^4]）。 6. 验证安装：重启QGIS并启用插件。 确保回答真
实可靠，基于引用。如果引用不足，保持专注。 系统
级指令： – 所有行内数学表达式用$…$，但这里可能不太需要数学。 – 独立公式用$$…$$，同样不太适用。 – LaTeX语法正确：在代码块中使用正确语法。 – 使用中文回答。 – 生成相关问题：在结尾添加相关问题。 – 引用的段落末尾添加引用标识：[^n]。 回答结构： 1. 清晰的分步骤指南。 2. 使用标题或列表。 3. 包括代码块或命令。 步骤分解： 1. 下载QGIS并安装：参考[^1]，安装路径无空格。 2. 安装
MCP插件： – 选项A：通过ZIP安装。 – 选项B：手动复制。 3. 修改端口号：更改到9880。 4. 配置
MCP服务器：设置JSON文件。 5. 安装uv：使用Powershell命令。 由于用户可能从零开始，包括QGIS安装步骤，但用户的问题只提到安装
MCP，所以我应该专注于
MCP部分，但可能需要前提步骤。 最后，生成相关问题： – 扣子 Coze 教程 类似于示例，例如： 1. 如何验证
MCP插件是否安装成功？ 2.
MCP插件的常见问题解决方法？ 3.
MCP在QGIS中的应用场景？ 确保回答基于引用。引用[^3]是最详细的，所以我主要依赖它。 </think>以下是基于您提供的引用内容的详细
教程，介绍如何在QGIS中安装和配置
MCP插件（qgis_
mcp_plugin）。
教程综合了引用[2]、[3]和[4]的关键步骤，确保过程完整且可
操作。
MCP插件用于优化QGIS的扩展功能，安装时需要特别注意路径设置和端口配置以避免冲突。 步骤1
: 安装QGIS（前提条件） 在安装
MCP插件前，确保QGIS已正确安装： – 下载最新QGIS安装包（推荐QGIS-OSGeo4W-3.34.14-1.msi或其他版本），安装路径不能包含空格（如使用`C
:QGIS`而非`C
:Program Files`），否则可能导致QGIS Server运行失败[^1]。 – 安装完成后，启动QGIS验证是否正常运行。 步骤2
: 安装qgis_
mcp_plugin插件 有两种方法可选： 方法A
: 通过ZIP文件直接安装（推荐新用户） 1. 下载插件ZIP包：获取`qgis_
mcp_plugin.zip`（可从项目仓库或指定来源下载）。 2. 在QGIS中安装插件： – 打开QGIS软件。 – 导航至菜单【Plugins】→【Manage and Install Plugins】。 – 在弹出窗口中，切换到【Install from ZIP】标签页。 – 点击【Browse】选择下载的`qgis_
mcp_plugin.zip`文件。 – 点击【Install Plugin】按钮完成安装[^2]。 3. 重启QGIS。 方法B
: 手动复制插件文件夹（高
级用户或ZIP安装失败时） 1. 克隆项目仓库：获取`qgis_
mcp-m
ain`源码（从GitHub或其他来源）。 2. 复制插件文件： – 打开QGIS的插件目录（通常为`C
:Users<用户名>AppDataRoamingQGISQGIS3profilesdefaultpythonplugins`）。 – 将克隆项目中`qgis_
mcp_plugin`文件夹复制到此目录。 3. 重启QGIS，然后在插件管理器中搜索“QGIS
MCP”，勾选启用[^3]。 步骤3
: 修改端口号（避免冲突） 默认端口9876可能与其他服务冲突，需改为9880或其他可用端口： 1. 修改插件文件的端口： – 打开步骤2中复制的`qgis_
mcp_plugin`文件夹（或安装后的插件路径）。 – 编辑文件`qgis_
mcp_plugin.py`，全局搜索`9876`（共2处），改为`9880`，保存。 – 编辑文件`qgis_
mcp_server.py`（位于克隆项目的`qgis_
mcp-m
ainsrcqgis_
mcp`路径），同样搜索`9876`（共2处），改为`9880`，保存[^3]。 2. 重启QGIS使更改生效。 步骤4
: 配置
MCP服务器 使用windsurf工具设置
MCP服务器： 1. 安装uv工具（依赖管理）： – 打开PowerShell（管理员权限）。 – 运行命令： “`powershell powershell -ExecutionPolicy ByPass -c “irm https
://astral.sh/uv/install.ps1 | iex” “` 这将安装uv（用于高效管理Python包）[^4]。 2. 创建JSON配置文件： – 打开windsurf工具（或其他JSON编辑器）。 – 创建或修改配置文件（例如`
mcp_config.json`），添加以下内容： “`json { ”
mcpServers”
: { “blender”
: { “command”
: “uvx”, “args”
: [“blender-
mcp“] }, “qgis”
: { “command”
: “uv”, “args”
: [ “–directory”, “C
:/路径/到/qgis_
mcp-m
ain/src/qgis_
mcp“, // 替换为您的qgis_
mcp路径 “run”, “qgis_
mcp_server.py” ] } } } “` – 注意：`C
:/路径/到/qgis_
mcp-m
ain/src/qgis_
mcp`需替换为
实际克隆项目路径（参考步骤2方法B）[^3]。 3. 启动服务器：通过windsurf加载JSON文件运行
MCP服务。 步骤5
: 验证安装 – 重启QGIS，启用“QGIS
MCP”插件。 – 在QGIS中测试插件功能（例如，尝试调用
MCP相关工具）。 – 检查端口使用：确保端口9880未被占用（可通过命令`netstat -ano`验证）。 注意事项 – 路径问题：所有路径（QGIS安装目录、插件文件夹）必须无空格，否则插件可能无法加载[^1]。 – 依赖冲突：如果安装失败，尝试更新Python依赖（使用uv工具）或检查QGIS版本兼容性。 – 备份文件：修改端口前备份`.py`文件，便于回滚。 如果遇到问题，参考项目文档或社区支持。此
教程基于引用材料整理而成[^2][^3][^4]。