工具介绍

1. 服务列表

iServer MCP服务列表提供一套完整的空间数据服务解决方案，包含地图服务、数据服务、二维网络分析服务、三维网络分析服务、交通换乘分析、地址匹配服务、空间分析服务等服务类型，覆盖空间数据查询、分析、匹配等全场景需求，可直接支撑城市规划、交通管理、商业分析等领域的空间数据应用：

2. 地图服务

地图服务聚焦地图资源的查询与管理，帮助用户快速获取地图基础信息、筛选空间数据，为地图可视化与数据应用提供支撑，包含以下工具：

• 查询所有的地图名称
• 根据地图名称查询其所有的图层名称
• 根据地图名称查询其有层级关系的图层信息
• SQL模糊查询
• 空间查询-包含
• 空间查询-相交
• 空间范围内的属性过滤

3. 数据服务

数据服务围绕数据源与数据集的全生命周期管理，提供数据基础信息查询、字段统计、多维度数据筛选等功能，为后续数据处理与分析奠定基础，包含以下工具：

• 获取当前数据服务组件对应的所有数据源名称
• 获取当前数据服务组件对应的所有数据源信息
• 获取指定数据源的信息
• 查询指定数据源下的所有数据集
• 查询指定数据源下的所有数据集名称
• 查询指定数据源下指定数据集的元信息
• 查询指定数据源下指定数据集的所有字段名称
• 对指定字段进行统计
• SQL查询-完全匹配
• SQL查询-大于小于查询
• SQL查询-模糊查询
• 空间查询-包含
• 空间查询-相交
• 缓冲区查询（不包含属性过滤）

4. 二维网络分析服务

二维网络分析服务针对二维空间网络场景（如交通路网、管网等），提供网络资源查询、设施查找、连通性分析、追踪分析等功能，支撑交通规划、管网运维等领域应用，包含以下工具：

• 获取网络名称列表
• 获取指定网络数据集中的权值字段名称列表
• 根据坐标点进行最近设施查找分析
• 根据结点ID进行连通性分析
• 根据弧段ID进行连通性分析
• 根据结点ID进行下游追踪分析
• 根据弧段ID进行下游追踪分析
• 根据结点ID进行上游追踪分析
• 根据弧段ID进行上游追踪分析
• 根据结点ID查找下游关键设施
• 根据弧段ID查找下游关键设施
• 根据结点ID查找上游关键设施
• 根据弧段ID查找上游关键设施
• 根据结点ID进行爆管分析
• 根据弧段ID进行爆管分析

5. 三维网络分析服务

三维网络分析服务针对三维空间网络场景（如立体交通、地下管网等），提供网络资源查询、汇/源查找、追踪分析、关键设施定位功能，满足三维空间下的复杂网络分析需求，包含以下工具：

• 获取网络名称列表
• 获取指定网络数据集中的权值字段名称列表
• 根据给定节点ID查找汇（sinks）
• 根据给定弧段ID查找汇（sinks）
• 根据给定节点ID查找源（sources）
• 根据给定弧段ID查找源（sources）
• 根据节点ID进行下游追踪分析
• 根据弧段ID进行下游追踪分析
• 根据节点ID进行上游追踪分析
• 根据弧段ID进行上游追踪分析
• 根据节点ID查找上游关键设施
• 根据弧段ID查找上游关键设施

6. 交通换乘分析

交通换乘分析服务专注于交通网络场景，为出行规划提供支持，帮助用户获取交通网络资源、计算最优换乘方案，包含以下工具：

• 获取交通网络名称列表
• 根据指定的起止点坐标及交通换乘分析参数进行交通换乘分析

7. 地址匹配服务

地址匹配服务提供地址与地理坐标的双向转换功能，满足地理编码与位置查询需求，包含以下工具：

• 反向地址匹配
• 正向地址匹配

8. 空间分析服务

空间分析服务提供基础的空间数据查询能力，覆盖数据集详情查询、字段属性分析、数据筛选与统计等功能，为后续复杂空间分析操作（如叠加分析、缓冲区分析等）提供核心数据支撑，包含以下工具：

• 查询所有的数据源名称
• 查询指定数据源下的所有数据集名称
• 查询指定数据集的完整元信息
• 叠加分析-相交
• 叠加分析-裁剪
• 叠加分析-擦除
• 叠加分析-更新
• 叠加分析-同一
• 叠加分析-合并
• 叠加分析-对称差
• 邻近分析
• 缓冲区分析
• 三维空间查询

自定义MCP工具提示词

默认 MCP 工具的提示词为通用化描述，在实际业务场景中存在局限性：

• 通用表述无法匹配业务专属术语（例如业务中 “专题地图” 的概念，通用提示词可能仅描述为 “地图”），易导致大模型调用 MCP 工具时出现匹配偏差；
• 默认提示词通常仅说明工具的基础功能，缺少业务场景下的约束条件（例如 “返回结果需排除测试用地图”），易造成工具调用结果不符合业务预期。

所以在SuperMap AgentX Server中支持通过自定义MCP工具提示词来解决上述问题。

操作步骤

查看目标工具的原始提示词

1. 在 SuperMap Agentx Server 的服务管理界面中，找到已部署的 MCP 服务列表，选定本次需调整的目标服务（例如map-Changjiang服务），点击复制该服务对应的访问 URL；

2. 打开终端窗口，执行 MCP Inspector 对应的npx启动命令；工具启动成功后，会自动打开其 Web 调试页面；

npx -y @modelcontextprotocol/inspector

3. 在 MCP Inspector 页面中，将传输类型选择为SSE，把复制的服务地址粘贴至 URL 输入框，点击 Connect 按钮建立连接；连接成功后，选择Tools工具标签页，会列出该服务下的所有 MCP 工具，找到目标工具（例如getMapNames），查看其当前的提示词。

修改提示词

1. 启动SuperMap AgentX Server，打开【SuperMap Agentx Server安装路径】/cfg/iserver-mcp/resources目录；

2. 打开目录下对应目标 MCP 服务的提示词配置文件（YAML 格式，通常以服务名称或工具集命名，例如map-map_zh.yaml，如需国际化，可以修改en结尾的yaml文件，例如map-map_en.yaml）；

3. 在 YAML 文件中找到目标工具对应的description字段，将其原有值替换为业务场景适配的新提示词（例如将原始的 “查询所有的地图名称，返回多个 GIS 地图的名称，且地图名不重名”，调整为 “查询长江流域专题 GIS 地图的唯一名称列表，返回结果需确保地图名无重复”）；修改完成后保存文件。

4. 提示词修改完成后，需重启iserver mcp server服务节点，让新配置生效。

验证提示词的修改结果

1. 刷新 MCP Inspector 页面，再次点击 Connect 建立连接；

2. 在新连接后的工具列表中，找到目标工具，查看其提示词已更新为修改后的提示词；也可简单发起工具调用，验证提示词与工具功能的匹配度。