生命周期 - Model Context Protocol 中文文档

Model Context Protocol (MCP) 为客户端-服务器连接定义了严格的生命周期，以确保正确的能力协商和状态管理。

初始化：能力协商和协议版本约定
运行：正常协议通信
关闭：优雅终止连接

生命周期阶段

初始化

初始化阶段 MUST 是客户端和服务器之间的首次交互。在此阶段，客户端和服务器会：

建立协议版本兼容性
交换并协商能力
共享实现细节

客户端 MUST 通过发送包含以下内容的 initialize 请求来发起此阶段：

支持的协议版本
客户端能力
客户端实现信息

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2025-11-25",
    "capabilities": {
      "roots": {
        "listChanged": true
      },
      "sampling": {},
      "elicitation": {
        "form": {},
        "url": {}
      },
      "tasks": {
        "requests": {
          "elicitation": {
            "create": {}
          },
          "sampling": {
            "createMessage": {}
          }
        }
      }
    },
    "clientInfo": {
      "name": "ExampleClient",
      "title": "Example Client Display Name",
      "version": "1.0.0",
      "description": "An example MCP client application",
      "icons": [
        {
          "src": "https://example.com/icon.png",
          "mimeType": "image/png",
          "sizes": ["48x48"]
        }
      ],
      "websiteUrl": "https://example.com"
    }
  }
}

服务器 MUST 以自身能力和信息进行响应：

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "protocolVersion": "2025-11-25",
    "capabilities": {
      "logging": {},
      "prompts": {
        "listChanged": true
      },
      "resources": {
        "subscribe": true,
        "listChanged": true
      },
      "tools": {
        "listChanged": true
      },
      "tasks": {
        "list": {},
        "cancel": {},
        "requests": {
          "tools": {
            "call": {}
          }
        }
      }
    },
    "serverInfo": {
      "name": "ExampleServer",
      "title": "Example Server Display Name",
      "version": "1.0.0",
      "description": "An example MCP server providing tools and resources",
      "icons": [
        {
          "src": "https://example.com/server-icon.svg",
          "mimeType": "image/svg+xml",
          "sizes": ["any"]
        }
      ],
      "websiteUrl": "https://example.com/server"
    },
    "instructions": "Optional instructions for the client"
  }
}

成功初始化后，客户端 MUST 发送 initialized 通知，表示已准备好开始正常操作：

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

在服务器响应 initialize 请求之前，客户端 SHOULD NOT 发送除 ping 之外的请求。
在收到 initialized 通知之前，服务器 SHOULD NOT 发送除 ping 和日志记录之外的请求。

版本协商

在 initialize 请求中，客户端 MUST 发送其支持的协议版本。该版本 SHOULD 是客户端支持的_最新_版本。如果服务器支持请求的协议版本，它 MUST 以相同版本响应。否则，服务器 MUST 以它支持的另一个协议版本响应。该版本 SHOULD 是服务器支持的_最新_版本。如果客户端不支持服务器响应中的版本，它 SHOULD 断开连接。

如果使用 HTTP，客户端 MUST 在随后发送给 MCP 服务器的所有请求中包含 MCP-Protocol-Version: <protocol-version> HTTP header。详情请参见传输中的协议版本 Header 小节。

能力协商

客户端和服务器能力会确定会话期间可用的可选协议功能。关键能力包括：

类别	能力	描述
客户端	`roots`	提供文件系统根目录的能力
客户端	`sampling`	支持 LLM 采样请求
客户端	`elicitation`	支持服务器引出请求
客户端	`tasks`	支持任务增强的客户端请求
客户端	`experimental`	描述对非标准实验性功能的支持
服务器	`prompts`	提供提示模板
服务器	`resources`	提供可读资源
服务器	`tools`	公开可调用工具
服务器	`logging`	发出结构化日志消息
服务器	`completions`	支持参数自动补全
服务器	`tasks`	支持任务增强的服务器请求
服务器	`experimental`	描述对非标准实验性功能的支持

能力对象可以描述如下子能力：

listChanged：支持列表变更通知（用于提示、资源和工具）
subscribe：支持订阅单个条目的变更（仅资源）

运行

在运行阶段，客户端和服务器按照协商出的能力交换消息。双方 MUST：

遵守协商出的协议版本
仅使用已成功协商的能力

关闭

在关闭阶段，一方（通常是客户端）会干净地终止协议连接。协议未定义特定关闭消息，而应使用底层传输机制来表示连接终止：

stdio

对于 stdio 传输，客户端 SHOULD 通过以下步骤发起关闭：

首先，关闭到子进程（服务器）的输入流
等待服务器退出；如果服务器未在合理时间内退出，则发送 SIGTERM
如果服务器在收到 SIGTERM 后仍未在合理时间内退出，则发送 SIGKILL

服务器 MAY 通过关闭其到客户端的输出流并退出，来发起关闭。

HTTP

对于 HTTP 传输，关闭通过关闭相关 HTTP 连接来表示。

超时

实现 SHOULD 为所有已发送请求设置超时，以防止连接挂起和资源耗尽。当请求在超时时间内未收到成功或错误响应时，发送方 SHOULD 为该请求发出取消通知，并停止等待响应。 SDK 和其他中间件 SHOULD 允许按请求配置这些超时。实现 MAY 在收到与请求对应的进度通知时选择重置超时计时器，因为这意味着工作确实正在进行。不过，无论是否收到进度通知，实现 SHOULD 始终强制执行最大超时，以限制行为异常的客户端或服务器造成的影响。

错误处理

实现 SHOULD 准备好处理以下错误情况：

协议版本不匹配
无法协商所需能力
请求超时

初始化错误示例：

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Unsupported protocol version",
    "data": {
      "supported": ["2024-11-05"],
      "requested": "1.0.0"
    }
  }
}

​生命周期阶段

​初始化

​版本协商

​能力协商

​运行

​关闭

​stdio

​HTTP

​超时

​错误处理

生命周期阶段

初始化

版本协商

能力协商

运行

关闭

stdio

HTTP

超时

错误处理