GPA MCP 工具扩展概述
GPA MCP 工具 是 SuperMap AgentX Server 基于 SuperMap GPA 核心能力打造的工具体系，整合了空间数据处理、分析、管理与格式交换能力，面向智能体调用场景完成能力封装。每一次工具调用，都会经过参数装配、调用 iServer GPA 算子执行、结果加工三个环节，最终把结果返回给大语言模型（LLM）。
内置 GPA MCP工具 已经能完成主要业务，但还需要在调用前校验参数、调用后记录结果、调整返回给模型的内容，或把某个工具接入自定义业务逻辑时，可以使用本章介绍的扩展方式。
GPA MCP 扩展主要面向已有工具的调用过程，不需要重新开发一个 MCP 服务，也不需要编译打包 JAR。扩展代码使用 Python 编写，通过工具 JSON 配置接入；容器内的 custom_handlers/ 目录对应产品包的 /cfg/gpa_mcp/v2_handlers/ 目录，扩展文件放入该产品包目录后即可生效。
扩展适用场景
- 调用前校验或改写参数，例如限制缓冲距离，超出范围时直接给出修改建议；
- 调用后记录日志、审计信息或通知外部系统，同时不影响工具原本返回结果；
- 改写返回给 LLM 的结果，例如补充业务字段、调整结果结构；
- 完全接管某个工具的业务处理过程，例如把工具转发到外部 REST API。
阅读索引
| 您想完成的任务 | 建议阅读 |
|---|---|
| 第一次接触 GPA MCP 扩展 | 工具调用链路与扩展点介绍 |
| 准备编写和挂载扩展代码 | 开发准备 |
| 想在业务执行前校验参数或改写请求 | 场景一：自定义调用前逻辑 |
| 想完全替换工具的业务处理过程 | 场景二：自定义业务处理 |
| 想调整返回给 LLM 的结果 | 场景三：自定义返回结果 |
| 想在业务执行后记录日志、审计或通知外部系统 | 场景四：自定义调用后逻辑 |
| 代码写完后想确认是否生效 | 收尾：部署、验证与排错 |
注意：GPA MCP 工具扩展只适用于 GPA MCP 工具，不适用于地图服务、数据服务等 iServer MCP 其他服务。其他 iServer MCP 服务的扩展方式请参考iServer MCP 工具扩展开发。