​
什么是 MCP？

NAabKC 本教程将手把手教你：
  1. 🎯 如何将现有的业务接口包装成 MCP 服务
  2. 🔧 如何配置让 AI 能够调用你的接口
  3. 💬 如何通过自然语言让 AI 帮你查询业务数据
我们以”行政区域查询”为例，演示完整流程。看完后，你就能把自己的任何业务接口都变成 AI 可调用的服务！

​
实际案例：让 AI 查询行政区域

​
现状分析

当前 PIGX 系统已经有一个行政区域管理模块，有对应的后台接口： 3SaNwn

​
我们的目标

让用户可以直接对 AI 说：
  • “帮我查一下北京市有哪些区”
  • “广东省下面有多少个地级市？”
  • “查询一下上海市浦东新区的行政代码”
AI 就能自动调用我们的接口，返回准确的数据： kKC64F
这就是 MCP 的魅力：用户用自然语言提问，AI 自动调用对应的业务接口获取数据！

​
三步实现 MCP 服务

1

第一步：添加 MCP 依赖包

就像安装软件一样，我们需要先添加 MCP 功能包到项目中。在你的 pigx-upms-biz 项目的 pom.xml 文件中添加：
<dependency>
    <groupId>com.pig4cloud</groupId>
    <artifactId>pigx-common-mcp</artifactId>
</dependency>
这个依赖包含了 MCP 协议的所有基础功能，添加后你的项目就具备了 MCP 能力。
2

第二步：给接口打上魔法标签

找到你想要让 AI 调用的接口方法，加上 @Tool 注解：
// 保持原有的所有注解不变，只需要新增一行
@Tool(description = "查询行政区划分页数据")
public R getSysAreaPage(@ParameterObject Page page, @ParameterObject SysAreaEntity sysArea) {
    // 原有业务逻辑保持不变
    // .... 
}
@Tool 注解就像给接口贴了个”AI可调用”的标签。description 参数要写清楚这个接口的作用，AI 会根据这个描述来判断什么时候调用这个接口。
3

第三步：在 AI 系统中配置服务

在 PIG AI 的 MCP 模块中，添加你的 MCP 服务配置：
配置项配置值说明
协议类型SSE选择 Server-Sent Events 模式
服务地址/mcp/sse微服务版本使用此地址
服务地址/admin/mcp/sse单体版本使用此地址
⚠️ 注意：微服务版本和单体版本的地址不同，请根据你的项目类型选择正确的地址！
nUK0mC

​
🎉 完成！开始体验

配置完成后，你就可以直接对 AI 说：

查询示例 1

“帮我查一下北京市有哪些区县”

查询示例 2

“广东省下面有多少个地级市？”

查询示例 3

“查询上海市浦东新区的行政代码”

查询示例 4

“显示所有直辖市的行政区划”
AI 会自动理解你的需求，调用对应的接口，并以友好的方式展示结果！

​
扩展应用

掌握了这个方法，你可以将任何业务接口都包装成 MCP 服务：
只要在对应的接口上加上 @Tool 注解，就能让 AI 理解并调用你的业务逻辑！