深入理解 MCP 协议：AI 时代的工具集成标准

深入理解 MCP 协议：AI 时代的工具集成标准

系列回顾

在上一篇文章 《Spring AI MCP 实战：手把手构建 Todo Manager 应用》 中，我们通过一个完整案例了解了如何使用 Spring AI MCP 开发应用。

本文作为系列的第二篇，将深入讲解 MCP 协议本身，帮助你从原理层面理解这一新兴标准。Java SDK 代码仅作为示例使用。

一、MCP 简介

1.1 什么是 MCP

**Model Context Protocol（MCP）**是一个开放的协议标准，用于定义 AI 模型与外部工具、资源之间的交互方式。

简单来说，MCP 想让 AI 模型能够像人类一样"使用工具"—— 只不过人类用鼠标点击，AI 通过协议调用。

1.2 为什么需要 MCP

在 AI 应用开发中，我们面临以下挑战：

MCP 的目标就是解决这些问题。

1.3 MCP 的设计目标

┌─────────────────────────────────────────────┐
│            MCP 设计目标                      │
├─────────────┬─────────────┬─────────────────┤
│   标准化    │  互操作性   │    可扩展      │
│  统一接口   │  跨语言平台  │  按需添加能力  │
│  规范       │  无缝通信   │  灵活扩展      │
└─────────────┴─────────────┴─────────────────┘

1.4 适用场景

1.5 与相关技术对比

二、核心架构

2.1 Client/Server 模型

MCP 采用经典的客户端 - 服务器架构：

┌─────────────────┐         ┌─────────────────┐
│   MCP Client    │         │   MCP Server    │
│  (请求发起方)    │◄───────►│  (能力提供方)    │
└─────────────────┘  JSON-RPC └─────────────────┘

角色说明：

2.2 传输层

MCP 支持多种传输方式：

STDIO 传输

┌──────────┐         ┌──────────┐
│  Client  │ ──stdin─►│  Server  │
│          │ ◄─stdout─│          │
└──────────┘         └──────────┘

• 基于标准输入/输出
• 适用于本地进程间通信
• 无需网络端口

HTTP SSE 传输

┌──────────┐         ┌──────────┐
│  Client  │ ──HTTP─►│  Server  │
│          │ ◄──SSE──│          │
└──────────┘         └──────────┘

• Server-Sent Events 单向推送
• 适用于远程服务
• 需要 HTTP 端口

Streamable HTTP 传输（推荐）

┌──────────┐         ┌──────────┐
│  Client  │ ◄──────►│  Server  │
│          │  双向流  │          │
└──────────┘         └──────────┘

• 双向流式通信
• 高效、低延迟
• 支持连接恢复

2.3 JSON-RPC 消息格式

MCP 基于 JSON-RPC 2.0 规范定义消息格式。

请求消息

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list",
  "params": {}
}

响应消息

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "tools": [...]
  }
}

错误响应

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32600,
    "message": "无效请求"
  }
}

三、服务器能力

MCP 服务器可以暴露以下几种能力：

3.1 Tools（工具）

Tools 是服务器暴露给客户端的可调用功能。

工具发现

客户端请求工具列表：

// 请求
{
  "method": "tools/list",
  "params": {}
}

// 响应
{
  "tools": [
    {
      "name": "create_todo",
      "description": "创建一个新的待办事项",
      "inputSchema": {
        "type": "object",
        "properties": {
          "title": {"type": "string", "description": "待办标题"},
          "description": {"type": "string", "description": "待办描述"}
        },
        "required": ["title"]
      }
    }
  ]
}

工具调用

// 请求
{
  "method": "tools/call",
  "params": {
    "name": "create_todo",
    "arguments": {
      "title": "学习 MCP",
      "description": "阅读协议文档"
    }
  }
}

// 响应
{
  "content": [
    {
      "type": "text",
      "text": " 待办已创建n  ID: 550e8400-e29b-41d4-a716-446655440000"
    }
  ]
}

Java SDK 示例

// Server 端注册工具
@Bean
public McpServerFeatures.SyncToolSpecification createTodoTool() {
    return SyncToolSpecification.builder()
        .tool(McpSchema.Tool.builder()
            .name("create_todo")
            .description("创建待办事项")
            .inputSchema(...) // JSON Schema 定义
            .build())
        .callHandler((exchange, request) -> {
            // 处理工具调用
            return McpSchema.CallToolResult.builder()...;
        })
        .build();
}

3.2 Resources（资源）

Resources 是服务器暴露的数据源，通过 URI 访问。

资源发现

// 请求
{"method": "resources/list"}

// 响应
{
  "resources": [
    {
      "uri": "todo://all",
      "name": "所有待办",
      "mimeType": "application/json"
    }
  ]
}

资源读取

// 请求
{
  "method": "resources/read",
  "params": {"uri": "todo://all"}
}

// 响应
{
  "contents": [
    {
      "uri": "todo://all",
      "text": "[{"id":"1","title":"学习 MCP"}]"
    }
  ]
}

资源订阅

// 订阅
{
  "method": "resources/subscribe",
  "params": {"uri": "todo://all"}
}

// 变更通知（服务器主动推送）
{
  "method": "notifications/resources/updated",
  "params": {"uri": "todo://all"}
}

3.3 Prompts（提示模板）

Prompts 是预定义的提示词模板。

// 获取 Prompt
{
  "method": "prompts/get",
  "params": {
    "name": "code_review",
    "arguments": {"language": "java"}
  }
}

// 响应
{
  "messages": [
    {
      "role": "user",
      "content": {
        "type": "text",
        "text": "请审查以下 Java 代码..."
      }
    }
  ]
}

3.4 其他能力

四、客户端能力

MCP 客户端也可以向服务器提供能力：

4.1 Roots（根目录）

Roots 定义服务器可访问的文件系统边界。

// 获取 Roots
{"method": "roots/list"}

// 响应
{
  "roots": [
    {"uri": "file:///project/src", "name": "源代码"}
  ]
}

4.2 Sampling（LLM 采样）

客户端提供 LLM 生成能力给服务器使用：

{
  "method": "sampling/createMessage",
  "params": {
    "messages": [...],
    "maxTokens": 100,
    "modelPreferences": {"hints": ["claude-sonnet"]}
  }
}

4.3 Elicitation（用户输入）

服务器通过客户端请求用户输入：

{
  "method": "elicitation/create",
  "params": {
    "message": "请选择操作类型",
    "requestedSchema": {
      "type": "object",
      "properties": {
        "action": {"type": "string", "enum": ["create", "update", "delete"]}
      }
    }
  }
}

五、消息协议详解

5.1 初始化握手

MCP 连接建立需要完成握手流程：

Client                          Server
  │                              │
  │──── initialize ────────────►│
  │                              │
  │◄───── initialize ───────────│
  │                              │
  │──── initialized ───────────►│
  │                              │
  │         连接建立完成          │

initialize 请求示例：

{
  "method": "initialize",
  "params": {
    "protocolVersion": "2024-11-05",
    "capabilities": {
      "roots": {"listChanged": true}
    },
    "clientInfo": {
      "name": "mcp-client",
      "version": "1.0.0"
    }
  }
}

5.2 能力协商

客户端和服务器在初始化时交换各自支持的能力：

// 服务器能力
{
  "capabilities": {
    "tools": {"listChanged": true},
    "resources": {"subscribe": true, "listChanged": true},
    "prompts": {}
  }
}

5.3 错误处理

标准 JSON-RPC 错误码：

六、Java SDK 快速上手

6.1 添加依赖

<dependency>
    <groupId>io.modelcontextprotocol.sdk</groupId>
    <artifactId>mcp</artifactId>
    <version>1.0.0</version>
</dependency>

6.2 创建客户端

// 创建传输层
McpAsyncTransport transport = new WebFluxSseClientTransport(
    "http://localhost:8080"
);

// 创建客户端
McpSyncClient client = McpClient.sync(transport).build();

// 初始化握手
client.initialize();

// 列出工具
var tools = client.listTools();

// 调用工具
var result = client.callTool(
    new CallToolRequest("create_todo",
        Map.of("title", "学习 MCP"))
);

6.3 创建服务端

// 创建传输层
WebFluxSseServerTransportProvider transport =
    new WebFluxSseServerTransportProvider();

// 创建服务端
McpSyncServer server = McpServer.sync(transport).build();

// 注册工具
server.addTool(toolSpec);

总结

本文系统讲解了 MCP 协议的核心内容：

1. 架构设计：Client/Server 模型 + 多种传输方式
2. 消息格式：基于 JSON-RPC 2.0
3. 服务器能力：Tools、Resources、Prompts
4. 客户端能力：Roots、Sampling、Elicitation
5. 握手协商：initialize 流程 + 能力交换

MCP 作为 AI 应用集成的新标准，其设计思想值得深入学习。掌握 MCP 协议，有助于我们更好地理解 AI Agent 生态的发展趋势。

系列导航

• 第一篇：Spring AI MCP 实战：手把手构建 Todo Manager 应用
• 本篇：深入理解 MCP 协议
• 下一篇：MCP 高级特性与最佳实践（筹备中）

参考资料

• MCP 官方协议规范
• Spring AI MCP 文档
• MCP Java SDK 源码