iServer GPA MCP工具

SuperMap iServer GPA MCP 工具是 SuperMap AgentX Server 基于 SuperMap iServer GPA 核心能力打造的工具体系，整合了 SuperMap iServer GPA 空间数据处理、分析、管理与格式交换能力，可满足地理信息领域多场景的空间数据加工、分析、管理及跨平台交互需求。同时面向智能体调用场景完成能力封装，为各类智能体提供专业、高效的 GIS 工具调用支撑。

工具介绍

iServer GPA MCP 工具目前已拆分出 8 个功能独立且互补的工具集，覆盖空间数据处理、格式转换、栅格分析、数据管理、类型转换、矢量分析、镶嵌数据集管理等空间数据处理能力，同时支持连接 PostgreSQL 等外部数据库空间数据，能够高效串联业务需求。

各工具集的功能概述、工具详情如下表所示，所有工具集可单独调用，也可根据业务需求组合使用。

序号	工具集名称	功能概述	工具详情
1	通用工具集	是 iServer GPA MCP 工具体系的基础支撑类工具集，聚焦 GIS 数据操作与任务管理基础需求，提供数据集检索、获取及异步任务状态查询等核心基础服务能力，适用于数据目录浏览、数据集快速定位、异步任务监控等场景，为各类 GIS 数据处理业务提供前置的数据检索与任务管控支撑，提升数据操作与任务管理效率。	共 5 个工具：关键字搜索数据集、智能搜索数据集（自动选择最佳策略）、按名称获取数据集信息、列出所有数据集（支持分页）、查询异步任务执行状态和结果
2	数据处理工具集	包含数据集合并、统计面内对象数等工具，提供了丰富的空间数据处理能力，以满足不同的数据加工需求，适用于GIS数据整理、空间数据优化等场景。	共 24 个工具：数据集合并、统计面内对象数、计算几何属性、图幅接边、提取边界线、矢量裁剪、融合、碎多边形合并、对特定对象进行碎多边形合并、提取对象 ID、追加列、追加行、更新列、拆分、去除冗余节点、添加字段、删除字段、属性更新、按过滤条件删除对象、保护性分解、面聚合、栅格数据重采样、栅格数据重分级、多图层加权叠加分析。
3	数据迁移工具集	包含导入类、导出类和数据迁移类工具，提供强大的多格式数据互操作与交换能力，支持主流GIS、CAD、三维模型及表格数据的输入与输出。	共 16 个工具，导入类包括导入Excel、CSV、DWG、FileGDBVector、ModelOBJ、ModelDAE、Model3DS、ModelGLTF、ModelX、ModelDXF、ModelFBX、Geo3DML；导出类包括导出为GeoJSON、FileGDBVector、SHP；数据迁移类包括将倾斜摄影数据导出为ECW。
4	栅格分析工具集	包含坡向分析、提取三维数据等工具，提供了栅格数据分析与处理等能力，适用于地形分析、资源调查、环境监测等场景，能够处理地形特征提取、数据插值、栅格与矢量数据转换等需求。	共 20 个工具：坡向分析、提取三维数据、提取指定面、提取指定线、提取等值面、点数据提取线、坡度分析、提取等值线、曲率计算、栅格矢量化、矢量栅格化、生成距离栅格（直线）、邻域统计、栅格数据基本统计、区域统计、区域几何统计、区域几何统计至属性表、普通克吕金、障碍样条、距离反比权重。
5	数据管理工具集	包含重建空间索引、创建矢量数据集等工具，提供了核心的空间数据组织、维护与优化能力，保障数据的完整性和可用性，适用于数据库管理、数据维护等场景。	共 7 个工具：重建空间索引、创建矢量数据集、删除数据集、数据集投影转换、矢量数据集坐标系转换、创建栅格数据金字塔、创建影像数据金字塔。
6	类型转换工具集	包含二三维数据集转换等工具，提供了丰富的空间数据类型与维度间相互转换的功能，实现点、线、面、体及网络数据结构的灵活变换，适用于三维建模与可视化、二维制图与打印等业务场景。	共 15 个工具：三维线->二维线、二维点->三维点、二维线->三维线、二维面->三维面、三维点->二维点、三维面->二维面、二维线->二维面、二维点->二维线、二维面->二维点、三维点->三维线、二维线->二维点、二维面->二维线、三维面->三维线、简单数据->CAD、网络->点。
7	矢量分析工具集	包含SQL查询、空间拓扑关系查询等工具，提供了基于矢量数据的空间关系判断、叠加运算与缓冲区分析的能力，适用于土地利用分析、选址分析、影响范围评估等业务场景。	共 10 个工具：创建地理缓冲区、SQL查询、空间拓扑关系查询、标识叠加分析、裁剪、多图层求交、多图层联合、擦除、交集取反（对称差）、更新。
8	镶嵌数据集工具集	包含创建影像金字塔、构建概视图等工具，提供了针对海量多源影像数据的专业化管理、处理与优化能力，适用于遥感影像管理、正射影像库建设等场景。	共 9 个工具：构建概视图（多进程）、创建影像金字塔、构建概视图、重建影像金字塔、重新指定路径、计算统计数据、添加影像数据、添加影像数据 (多进程)、创建镶嵌数据集。

工具部署

Docker安装包

编辑环境变量配置文件.env ，添加 iServer 服务接口地址和访问 iServer 服务所需的查询参数认证的 token值。token 可前往 iServer 服务，点击用户名，在下拉菜单的"令牌”处申请。

...
# ENV for gpa mcp server
GPA_ISERVER_ROOT_URL=http://{ip地址}:{端口}/iserver
GPA_ISERVER_TOKEN=<生成的令牌>
...

Kubernetes安装包

编辑环境变量配置文件values.yaml ，添加 iServer 服务接口地址和访问 iServer 服务所需的查询参数认证的 token值。token 可前往 iServer 服务，点击用户名，在下拉菜单的"令牌”处申请。

# GIS 服务配置

iserver:
  provider: "Built-in"       #可选值： Built-in | External | None
  username: "agentx_admin"
  password: "agentx@2025"
  rootUrl: "http://agentx-iserver:8090/iserver"
  token: "<生成的令牌>"

...

自定义GPA模型注册为MCP工具

{
    "name": "sps.WorkflowProcessFactory.models.readgdbwriteouttodsfdirectory:readgdbwriteouttodsfdirectory",
    "description": "读取GDB数据，通过创建格网索引，写出DSF目录。",
    "inputSchema": {
      "type": "object",
      "properties": {
        "readgdb-path": {
          "type": "string",
          "description": "GDB文件路径: 指定的待处理的GDB文件路径"
        },
        "saveasdsf-path": {
          "type": "string",
          "description": "DSF目录的路径: 指定的结果DSF目录路径"
        },
        "readgdb-fields": {
          "type": "array",
          "description": "字段选择: 需要读取的字段列表"
        },
        "readgdb-ignoreNullGeometry": {
          "type": "boolean",
          "description": "忽略空几何对象: 是否忽略空几何对象"
        }
      },
      "required": [
        "readgdb-path",
        "saveasdsf-path"
      ]
    },
    "outputSchema": {
      "type": "object",
      "properties": {
        "saveasdsf-resultPath": {
          "type": "string",
          "description": "写出DSF目录-结果文件路径"
        }
      }
    }
  }

发布模型
将构建好的 GPA模型发布至 iServer GPA 服务的模型列表。
获取工具信息
在 WebGPA 建模页面，点击“模型”标签，找到已发布模型，右键菜单选择“打开资源页面”。在模型资源页面查看工具ID、描述及输入和输出参数。
配置 MCP工具
编辑配置文件 cfg/gpa_mcp/tools.json ，参照文件中的示例添加新MCP工具。其中 name 填写步骤 2 获取的工具ID，description 填写描述信息，inputSchema 和 outputSchema 分别填写输入参数和输出参数信息。
集成 MCP 工具
在添加MCP服务器时选择SSE类型，并指向 GPA MCP 接口地址：http://<ip地址>:8490/agentx/workflow/api/gpamcp/sse/v1，即可自动识别并集成所有已配置的GPA工具。