← 课程目录 🚀 从零到一
📐 学习维度 阶段6 · 第23章 Spring AI / LangChain4j 🚀 从零到一 📚 课程目录 🏠 首页 🛤️ 学习路径

23.4 MCP协议与Server开发

审校 2026-09-25 · 素材来源:L25-Agent模式与MCP协议、spring-ai-mcp-server-demo实操(脱敏改写)
📑 本篇章节导航 (共7节,点击直达)
架构:Host、Client、ServerMCP 与 Function Calling:一层管调用,一层管接入写一个 MCP Server生态与延展踩坑清单面试怎么问一句话总结

22.3 结尾留了钩子:Function Calling 解决「我的应用调我的工具」,但工具换个应用就得重写一遍接入——数据库查询工具给聊天助手写一份、给代码助手写一份、给办公助手再写一份。MCP(Model Context Protocol:Anthropic 2024 年提出的模型与外部工具/数据源连接的开放标准协议)把这层抽成标准:工具提供方写一次 Server,所有支持 MCP 的应用都能用——类比 USB:外设厂家按标准生产一次,插谁家的电脑都能识别。

架构:Host、Client、Server

三方角色先分清。Host(宿主:AI 应用本体,如 IDE 助手、你的客服系统)是消费方;MCP Client(宿主内的协议客户端,负责与 Server 通信)一个 Host 可挂多个;MCP Server(工具与数据的服务端,独立进程暴露能力)由工具提供方实现。一个 Server 暴露三类原语(协议里定义的标准能力类型):Tools(可被模型调用的函数:查库、发请求)、Resources(可读取的数据:文件、记录)、Prompts(预置提示词模板:代码审查模板、翻译模板)。传输两种:stdio(标准输入输出,本地子进程,零网络开销,适合本机工具)与流式 HTTP(远程服务,SSE 升级版,适合团队共享的服务)。连接建立后有一步能力发现(initialize 握手:Client 上线时问一次「你有哪些工具、参数 Schema 是什么」,缓存清单供模型选择)——工具列表是握手时快照的,Server 热加了新工具要通知重协商或重连,这是「明明部署了新工具模型却看不见」的原因。三类原语的选用也有感觉可循:Tools 是给模型自主调用的能力;Resources 更像「给模型读的素材」——一份配置说明、一段接口文档挂成 Resource,模型按需读取;Prompts 把「成熟的提问方式」固化在 Server 侧供消费方取用。一句话定位:Tools 是能力、Resources 是素材、Prompts 是套路,该做成分开的就别都揉成工具。

MCP 与 Function Calling:一层管调用,一层管接入

高频对比题一次说清。FC 是模型侧协议——规定「模型怎么表达我要调工具」;MCP 是工具侧协议——规定「工具怎么标准化暴露」。两者不是竞争而是上下层:MCP Server 暴露的工具,最终下发到模型时仍是 FC 格式的 tools 定义,模型返回的 tool_call 仍由 Host 执行——只是执行的代码从「每个应用自己写的胶水」变成了「通用 MCP Client 调 Server」。价值对比落在复用:FC 模式 N 个应用 × M 个工具要写 N×M 次接入,MCP 模式工具方写 M 个 Server、应用方做 1 次 MCP 接入即全量获得——M×N 变 M+N,这就是标准协议的经典红利(HTTP 之于信息、JDBC 之于数据库,同一个故事)。Java 生态的对应关系也顺手记下:Spring AI 的 @Tool 注解在 23.1 的语境里是 FC 工具注册,在 MCP Server 语境里是 MCP 工具暴露——同一套注解、两种发布形态,框架把「写工具」与「暴露工具」解耦了。

写一个 MCP Server

Spring AI 提供 MCP Server Starter,把普通 Spring 方法变成 MCP 工具:


@Service
public class OrderTools {
    @Tool(description = "按订单号查询订单状态")
    public OrderStatus queryOrder(
            @ToolParam(description = "订单号") String orderId) {
        return orderService.status(orderId);   // 正常业务代码
    }
}

spring:
  ai:
    mcp:
      server:
        name: order-mcp-server
        version: 1.0.0

@Tool 方法自动注册为 MCP 工具,Client 侧(无论是 IDE 插件还是你的 ChatClient 应用)连上即用——22.3 手写的五步 FC 流程(意图→执行→回传)在协议层自动运转。开发调试的实操路线:先写 Server 起服务,用官方 Inspector 工具连上验证工具清单与调用(不用先写 Client),再挂进应用——「先验证服务、再接消费方」,与 19.1 先 telnet 通端口再写代码是同一条排障顺序。安全三件事必须自己守住:鉴权(流式 HTTP 传输下 Server 要验调用方身份,不能裸奔内网——内部工具被外网扫到的事故年年有);最小暴露(只注册只读查询类工具,写操作按 22.3 的 MANUAL 哲学收口);审计日志(谁、何时、调了什么工具、参数是什么——工具是被 LLM 触发的,出问题时没有日志就是黑盒)。

生态与延展

MCP 的真正威力在生态:主流编辑器、聊天客户端原生支持挂 MCP Server,社区工具库(搜索、文件、数据库、浏览器操作)即插即用——你的应用既是 MCP 消费方(挂别人的工具),也可以是提供方(把公司内部服务暴露成 MCP Server,全公司的 AI 应用共享)。再往外一步是 A2A(Agent-to-Agent:Google 2025 年提出的智能体间协作协议)——MCP 管「Agent 与工具」,A2A 管「Agent 与 Agent」,如同员工用工具与员工协作是两个维度,两者互补不互斥。23.5 的 Agentic 演进里,工具生态标准化正是智能体爆炸的前提。企业落地还剩一层治理要自己搭:工具注册中心(公司里有哪些 Server、找谁申请权限)与版本管理(Server 升级参数 Schema 一变,没通知到的消费方调用就炸)——标准协议解决「怎么连」,「管什么、谁来管」永远是每个公司自己的功课。

踩坑清单

面试怎么问

一句话总结

MCP 把工具接入从「每家应用各自焊线」升级成「USB 标准即插即用」——Server 一次实现全生态复用,Spring AI 一个注解就能把业务方法暴露成标准工具;接入红利之外,鉴权、最小暴露、审计三件安全事永远是工具方自己的责任。