MCP 服务

MCP（Model Context Protocol）是一种通用的工具接入协议。很多地图服务商、数据平台和开发工具都提供 MCP 服务，接进 OpenGeodex 后，它们的工具就能像插件工具一样被智能体调用。

适合用 MCP 的情况：你要用的服务已经有现成的 MCP，但 OpenGeodex 没有对应的插件。已经有插件的能力（GDAL、PostGIS、QGIS 等）请优先用插件。

添加 MCP 服务

打开「设置 → 连接与扩展 → MCP 服务」，点「添加 MCP」。MCP 服务的说明文档里会给出启动命令或服务地址，按对应的连接方式填写。

字段	说明
名称	必填，在列表里显示，例如“文件系统”
命名空间	工具名前缀，用来区分不同服务的同名工具，例如 fs；留空时使用名称
连接方式	本地命令（stdio）或远程服务（HTTP），见下文
可用专家	哪些专家也能用这个服务的工具
启用	关掉后保留配置，但智能体不再使用

本地命令（stdio）

服务在你的电脑上以一个程序的形式运行，OpenGeodex 负责启动和关闭它。

• 命令：可执行程序，例如 npx、uvx 或某个 .exe 的完整路径；
• 参数：其余部分，以空格分隔；
• 环境变量：服务需要密钥时，按它的文档加在这里，例如名称 API_KEY、值 sk-...。

例如官方的文件系统服务，命令填 npx，参数填：

-y @modelcontextprotocol/server-filesystem D:/data

用 npx 或 uvx 启动的服务需要本机能访问对应的包源；首次启动会下载服务程序，需要等一会儿。

远程服务（HTTP）

服务运行在服务器上，OpenGeodex 通过网址连接。

• URL：服务给出的 MCP 地址，以 http:// 或 https:// 开头；
• 请求头：需要鉴权的，在这里添加，例如名称 Authorization、值 Bearer <你的 Token>。

密钥加密保存

环境变量和请求头的值保存时加密存储在本机，智能体和大模型看不到这些值。换电脑或换 Windows 账号后需要重新填写。

谁能用 MCP 工具

• 主 Agent（总管）始终可以用所有已启用的 MCP 服务；
• 「可用专家」里勾选的专家（采集专家、处理专家、遥感专家、WebGIS 专家）也能用；
• 一个都不勾选时，只有总管能用。

按需加载

MCP 服务的工具不会一次性全部塞给模型。智能体先只知道“有哪些 MCP 服务、各自能做什么”，真正需要时才加载某个服务的工具，这样接了很多服务也不会挤占上下文、拖慢回复。

所以在对话里点名会更快：“用某某地图 MCP 查一下……”“用文件系统 MCP 列出 D:/data 下的文件”。

写操作与安全

• MCP 工具在对话里的工具卡片上标为“外部 MCP”；
• 会修改数据的 MCP 工具同样走「写操作审批」。服务声明了“会修改”的工具一律按写操作处理；没有声明的，OpenGeodex 按工具名保守判断，名字里带 create、delete、update、save 等字样的都要先经你确认；
• MCP 服务是第三方程序，它能访问什么由它自己决定，不受 OpenGeodex 沙箱限制。请只添加来源可信的服务；本地命令类服务以你的 Windows 账号权限运行，像文件系统这类服务，参数里只给需要的目录。

管理与排查

• 列表里每个服务可以「编辑」、切换启用、删除；
• 服务连不上时，先确认命令或 URL 能在服务文档说明的环境下正常运行，再检查环境变量和请求头是否填对。