MCP通过 JSON‑RPC 在预定义通道上交换标准化消息。很多开发者在实际落地时常遇到以下痛点：

• 不知道该用哪种传输方式？
• 初始化阶段卡住导致工具列表永远获取不到。其实，
• 调用工具后没有收到响应。AI 模型陷入死循环，说起来，
• 会话结束后资源没有释放。导致端口占用或子进程残留。

🔌 主要架构概览

整个架构由几个关键部分组成：

• MCP 客户端 AI 应用内部组件，负责发起所有请求。按理说，

• MCP 服务端 你的 Spring Boot 服务。负责响应请求并执领域务逻辑。说起来，

• 传输层 客户端与服务端的通信方式，MCP 协议主要定义了两种标准传输机制：

  • 标准输入/输出 本地通信。客户端将服务端作为子进程启动，通过 stdin/stdout 交换消息，消息之间通过换行符分隔。
  • HTTP with Server‑Sent Events 网络通信，客户端通过 HTTP 与服务端交互。服务端必须提供两个端点：
    • 用于客户端接收消息的 SSE GET 端点。
    • 用于客户端发送消息的常规 HTTP POST 端点。

• 消息协议 所有传输的消息都遵循 JSON‑RPC 规范。主要有三种类型：

  • 请求 客户端发起调用，包含唯一的 id服务端必须**回复对应的 Response。
  • 通知 客户端发起但没有 ID,服务端**不需要**回复。
  • 响应 服务端对 Request 的回复，包含相同的 ID 与结果或错误信息。

📡 主要生命周期与接口详解

. 连接与初始化

This is “handshake” stage – without a successful handshake,every subsequent step will stall.

SSE 模式下的“发现服务端点”

If you choose SSE transport。client first performs a long‑polling GET request. The server n pushes an endpoindata) event containing POST URL for later messages.

GET /sse HTTP/1.1
Host的观点是，your-spring-boot-server.com
Accept这方面，text/event-stream

event: endpointdata
说到data，/message?sessionId=abc123

发送初始化请求

The client tells server its protocol version and capabilities.

{
"jsonrpc": "2.0","id": 1,"method": "initialize","params": {
"protocolVersion": "1.0","capabilities": {
"roots": { "listChanged": true }
},"clientInfo": {
说到"name"，"my-ai-client","version": "0.1"
}
}
}

服务器返回自身能力

{
"jsonrpc": "2.0"。"id": 1,"result": {
"protocolVersion": "1.0","capabilities": {
"tools": { "listChanged": true }
},"serverInfo": {
至于"name"，"my-spring-mcp-server","version":"0.1"
}
}
}

发送 `initialized` 通知

{
"jsonrpc":"2.0","method":"notifications/initialized"
}

. 工具发现 – “我能调什么？” 的答案在这里

The client asks server for a list of available tools;each tool comes with a JSON Schema that describes required arguments.

{
"jsonrpc":"2.0","id":2,"method\":\"tools/list"
}

{
"jsonrpc":"2.0","id\":2,"result\":{
"tools":,"description\":\"温度单位\"
}
},"required\":
}
}
]
}
}

. 工具调用 – 实际业务交互的主要环节

The AI model decides to use a tool based on its reasoning output. The client wraps this decision into a `tools/call` request.

{
"jsonrpc":"2.0",“id”:3,“method”:“tools/call”,“params”:{
至于“name”，“get_wear”,“arguments”:{
说到“city”，“杭州”,“unit”:“celsius”
}
}
}

If everything works,server replies with structured content that model can directly render.

{
“jsonrpc”:“2.0”。“id”:3,“result”:{
“content”:,“isError”:false
}
}

⚡️ 小贴士：If your tool call seems to hang,check that you have sent `initialized` notification and that `id` matches in both request & response.

SSE 流式返回

The server may push intermediate progress events before sending final result:

event的观点是，progress
data这方面，{"percent":40}
---
event的观点是，progress
再看data，{"percent\":80}
---
再看event，result
从data来看，{"content":}

. 会话关闭 – 防止资源泄漏

A graceful shutdown releases sockets,kills child processes and clears session state.

{
“jsonrpc”:“2.0”,“id”:4,“method”:“shutdown”
}

{
”jsonrpc″:“2.0”,”id″:4,”result″:{}
}

The final `exit` notification tells client it can safely terminate its connection.