开发准备

无论是扩展现有服务还是开发全新服务,开始编码前都需要先完成示例工程获取与 Maven 项目配置。

获取扩展开发示例工程

前往gitee仓库获取 MCP 扩展示例工程文档和配置文件,包含两个示例工程,用于演示如何为 SuperMap iServer MCP Server 开发扩展。这些示例涵盖两种主要扩展场景:创建全新的 MCP 服务和扩展现有 MCP 服务的功能。

配置 Maven 项目

创建一个标准的 Java 库项目(例如 mcp-service-tool-extension),并配置 pom.xml。pom.xml 文件中必须包含以下三个核心依赖,并将它们的 <scope> 设置为 provided。

  • iServer 服务模型:com.supermap.ibase:service-model:jar:12.0.1-SNAPSHOT:provided
  • MCP SDK 核心:com.supermap:mcp-sdk-core:jar:12.0.1-SNAPSHOT:provided
  • Spring AI 模型注解:org.springframework.ai:spring-ai-model:jar:1.0.0-M8:provided

代码示例:

<dependency>
<groupId>com.supermap.ibase</groupId>
<artifactId>service-model</artifactId>
<version>12.0.1-SNAPSHOT</version>
<scope>provided</scope>
</dependency>
<dependency>
<groupId>com.supermap</groupId>
<artifactId>mcp-sdk-core</artifactId>
<version>12.0.1-SNAPSHOT</version>
<scope>provided</scope>
</dependency>
<dependency>
<groupId>org.springframework.ai</groupId>
<artifactId>spring-ai-model</artifactId>
<version>1.0.0-M8</version>
<scope>provided</scope>
</dependency>

注意:

我们提供了一份 third-party-dependencies.txt 文件,列出了 iServer MCP Server 已自带的所有第三方库。如果您需要使用其中的依赖,请务必也将它们的 <scope> 设置为 provided,以避免部署时发生版本冲突。

准备工作完成后,请根据实际需求进入对应场景:场景一:扩展现有 MCP 服务的工具,或场景二:开发全新的领域 MCP 服务。