您的位置首页 >人工智能 >

用 Java 接入大模型(二十一)MCP 协议入门与 Java 集成

MCP 全称 Model Context Protocol,是一套标准化协议,用来让大模型安全调用外部工具、本地文件、数据库、业务接口,解决之前各家大模型工具调用格式不统一、对接成本高的痛点,本篇作为 Java 接入大模型系列的第二十一篇,先把 MCP 协议核心概念讲清楚,再给 Java 项目集成 MCP 客户端的完整流程,你可以直接在 SpringBoot 或者原生 Java 工程里面引入依赖、连接 MCP Server、构造工具调用请求,让大模型通过 MCP 去读取本地资源、执行自定义业务能力;MCP 分为服务端 MCP Server 和客户端 MCP Client,Java 侧一般做 Client 对接,通过 stdio 或者 HTTP 两种传输方式和 MCP 服务通信,协议本身是基于 JSON-RPC 封装,不用自己处理复杂的报文规范,现有开源 SDK 已经封装好序列化、心跳、能力发现、工具调用返回结果解析,对比原生 Function Call,MCP 最大优势是一套协议适配所有支持 MCP 的大模型和工具服务,不用针对每个模型单独改写工具入参结构。

一、MCP 协议核心角色与传输方式对照表

角色职责常用传输方式Java 侧关注点
MCP Server向外暴露工具、资源、提示词模板,声明自身能力stdio、HTTP(SSE)对接地址、启动命令、权限控制
MCP Client向 MCP Server 查询能力、发起工具调用,转发给大模型stdio、HTTPSDK 调用、请求封装、结果回调、异常捕获
LLM 大模型接收工具描述,判断什么时候调用工具,解析返回内容模型原生接口把 MCP 拿到的 tools 列表传给大模型

二、MCP 协议基础核心概念清单

  1. 能力发现(listTools):Client 发起请求,Server 返回自己支持哪些工具、每个工具的名称、描述、入参 JSON Schema。
  2. 工具调用(callTool):Client 携带工具名称、入参发给 Server,Server 执行逻辑,返回结果。
  3. 资源读取(readResource):读取本地文件、数据库记录这类上下文资源。
  4. 提示模板(getPrompt):预定义好的 prompt 模板,支持参数渲染。
  5. 初始化握手(initialize):Client 和 Server 第一次连接的时候协商协议版本、功能支持,版本不兼容直接报错断开。

三、Java 集成 MCP 的实施步骤

  1. 选择 Java MCP SDK,目前主流是官方 Java SDK 或者 spring-ai-mcp 集成包,在 pom.xml 引入 Maven 依赖。
  2. 配置 MCP Server 连接信息:如果是 stdio 模式配置服务启动命令;HTTP 模式填写服务 URL、超时、鉴权 Token。
  3. 创建 McpClient 实例,执行 initialize 握手,校验协议版本。
  4. 调用 listTools 拉取全部可用工具列表,把工具描述转换成大模型可识别的 Function 描述。
  5. 大模型返回需要调用工具的指令,通过 McpClient 执行 callTool,拿到工具返回数据。
  6. 将工具返回结果再次丢回大模型,由模型整合信息输出最终回答。
  7. 增加重试、超时、异常捕获、日志埋点,生产环境增加权限校验,限制高危工具执行。

四、MCP 和原生 Function Call 的差异

  • Function Call:是大模型厂商单独定义的,OpenAI、通义、豆包格式略有差别,工具只能给这一个模型使用。
  • MCP 协议:独立于大模型的通用标准,同一个 MCP Server,可以同时给多款支持 MCP 的大模型调用,工具复用性强。
  • 传输:Function Call 走模型 HTTP 接口;MCP 支持 stdio 本地进程调用、HTTP 远程服务两种模式,适合本地安全工具。

五、Java 集成 MCP 常见坑点清单

  • stdio 模式下 MCP 服务进程卡死,Java 进程没有做进程销毁,出现僵尸进程。
  • 协议版本不一致,握手 initialize 直接失败,要锁定 MCP 协议版本号。
  • 工具入参 Schema 校验不严,传入非法参数导致 Server 抛出异常。
  • 超时时间设置太短,文件读取、数据库查询慢,直接触发超时中断。
  • 权限无隔离,MCP Server 开放了删除文件、执行系统命令等高风险能力。

【相关 FAQ】

问题 1:MCP 协议入门,在 Java 接入大模型项目里面 MCP 协议到底解决什么问题?

回答 1:在 Java 接入大模型的场景里,MCP 协议统一了大模型调用外部工具的交互规范,不用为不同大模型单独适配 Function Call 格式,Java 客户端只需要对接一套 MCP Server,就能给多个大模型复用同一批工具、文件资源能力。

问题 2:Java 集成 MCP 协议,stdio 和 HTTP 两种传输方式该怎么选?

回答 2:本地内网、安全工具、本地文件读取场景优先 stdio 模式,直接拉起子进程,隔离性好;多服务远程调用、分布式 SpringBoot 集群场景,优先 HTTP+SSE 方式,方便统一管理 MCP 服务。

问题 3:Java 集成 MCP 协议,是不是所有大模型都能直接支持 MCP?

回答 3:不是,需要大模型侧支持读取 MCP 输出的工具能力描述;Java 的 MCP Client 负责拉取工具列表、执行调用,再转换成对应大模型的 Function 入参,部分模型原生已经兼容 MCP 格式,适配成本更低。

问题 4:Java 接入大模型使用 MCP 协议,生产环境需要额外做哪些防护?

回答 4:Java 集成 MCP 上线前要做好协议版本锁定、调用超时控制、进程生命周期管理、入参 Schema 校验,同时严格管控 MCP Server 权限,禁止开放高危系统操作工具,增加调用日志和审计记录。

【参考资料】

[2026-11-20](用 Java 接入大模型(二十一):MCP 协议入门与 Java 集成)InfoQ

[2026-11-19](Model Context Protocol 官方文档:Java SDK 介绍)GitHub MCP

[2026-11-19](Spring AI MCP 集成文档,Java 客户端快速上手)Spring 官方文档

[2026-11-17](MCP 协议 JSON-RPC 报文详解,工具调用流程解析)掘金

[2026-11-12](MCP 协议和 Function Call 对比,Java 工程落地踩坑总结)云栖社区

【免责声明】

本文为 MCP 协议入门与 Java 集成技术科普内容,文中 SDK、依赖版本、调用规范随 MCP 协议迭代持续更新;不同厂商大模型对 MCP 的适配程度存在差异,代码样例仅作学习参考,上线生产环境前请充分做安全测试、压力测试,本文不构成线上项目落地、技术选型的唯一决策依据。