MCP会话与传输:初始化完成之后再工作
MCP会话与传输:初始化完成之后再工作,从执行机制、错误边界与可运行例子理解工程取舍。
能向进程写入JSON,并不意味着MCP会话已经就绪。初始化需要交换版本和能力,客户端核对响应后再发initialized通知。业务调用抢在这之前,可能被拒绝,也可能在不支持的能力上出现难以解释的错误。
请求、响应与通知
JSON-RPC请求通过id与响应配对,响应包含result或error。通知没有id,不期待响应;等待通知回包会把客户端挂住。多个请求并发时,应维护pending表,按响应ID完成对应等待,而不是假设响应顺序与发送顺序一致。
协议错误与业务工具失败应分层记录。未知方法是协议路由问题;工具成功收到调用但业务拒绝,通常通过工具结果表达。重复请求ID、迟到响应、解析失败和连接关闭都需要明确处理,不能把任何JSON对象都当成功结果。
stdio与Streamable HTTP
stdio由客户端启动子进程,以stdin/stdout交换换行分隔的UTF-8协议消息。日志走stderr,不能将“服务已启动”打印到stdout污染协议。JSON字符串中的换行需要正确转义,不能把一条消息直接拆成多行。父进程还应处理子进程退出、管道关闭和stderr积压。
以本页固定的2025-11-25规范为准,远端标准传输为Streamable HTTP,支持HTTP请求以及可选SSE消息流;它取代更早的HTTP+SSE形态。客户端实现需明确目标版本,不能把任何名为SSE的接口当兼容MCP。HTTP连接生命周期、协议会话和业务任务生命周期也不是同一个概念。
跟做:真实子进程中的握手顺序
保存为session_transport.py,运行python -X utf8 session_transport.py。同一个文件加--server时成为子进程。父进程先发送故意越序的调用观察拒绝,再完成握手并列出空工具列表。它实现教学子集,不支持完整参数校验、所有错误、HTTP或外部SDK互通,不能当生产Server。
"""同文件以子进程模式走真实stdio;只实现教学用协议子集。"""
import json
import subprocess
import sys
class Session:
def __init__(self):self.state='new'
def handle(self,message):
method=message.get('method');request_id=message.get('id')
if method=='initialize' and self.state=='new':
self.state='initializing'
return {'jsonrpc':'2.0','id':request_id,'result':{'protocolVersion':'2025-11-25','capabilities':{'tools':{}},'serverInfo':{'name':'teaching','version':'1'}}}
if method=='notifications/initialized' and self.state=='initializing':
self.state='ready';return None
if request_id is None:return None
if self.state!='ready':return {'jsonrpc':'2.0','id':request_id,'error':{'code':-32000,'message':'not_ready'}}
if method=='tools/list':return {'jsonrpc':'2.0','id':request_id,'result':{'tools':[]}}
return {'jsonrpc':'2.0','id':request_id,'error':{'code':-32601,'message':'method_not_found'}}
def serve():
session=Session()
for line in sys.stdin:
reply=session.handle(json.loads(line))
if reply is not None:print(json.dumps(reply),flush=True)
def main():
messages=[{'jsonrpc':'2.0','id':0,'method':'tools/list'},
{'jsonrpc':'2.0','id':1,'method':'initialize','params':{'protocolVersion':'2025-11-25','capabilities':{},'clientInfo':{'name':'demo','version':'1'}}},
{'jsonrpc':'2.0','method':'notifications/initialized'},
{'jsonrpc':'2.0','id':2,'method':'tools/list'}]
with subprocess.Popen([sys.executable,'-X','utf8',__file__,'--server'],stdin=subprocess.PIPE,stdout=subprocess.PIPE,text=True,encoding='utf-8') as process:
# 客户端先读initialize响应,再发送initialized通知。
def exchange(message):
process.stdin.write(json.dumps(message)+'\n');process.stdin.flush()
return json.loads(process.stdout.readline())
early=exchange(messages[0]);init=exchange(messages[1])
assert init['id']==1 and init['result']['protocolVersion']=='2025-11-25'
process.stdin.write(json.dumps(messages[2])+'\n');process.stdin.flush()
ready=exchange(messages[3])
process.stdin.close();process.wait(timeout=5)
print('初始化前',early['error']['message'])
print('协议版本',init['result']['protocolVersion'])
print('就绪后',ready['result'])
if __name__=='__main__':
if '--server' in sys.argv:serve()
else:main()实际运行输出:
初始化前 not_ready
协议版本 2025-11-25
就绪后 {'tools': []}客户端确实等到initialize响应并核对协议版本后,才发送initialized通知;最后tools/list成功。把发送通知那两行删去,最后仍处于initializing状态,结果没有tools列表。程序中的readline为便于讲解没有总读取deadline,生产客户端要使用可取消的异步读和超时,否则故障子进程可能永久阻塞。
断线与恢复
连接断开不保证服务端动作没执行。重连后重新协商能力,按协议版本处理会话恢复支持,再根据业务操作ID确认未决调用;不能把所有pending请求无条件重放。服务端会话ID不是用户身份,访问仍需认证授权。
兼容测试应覆盖不支持版本、通知不回包、未知方法、错误ID、子进程提前退出、流中断和重复业务操作。HTTP传输还要检查Origin、认证、反向代理缓冲和SSE解析。只跑通初始化并不代表完整互通。
综合追问:初始化已写入管道,但后续工具调用挂住,怎样查协议状态?
这是给定条件下的机制推演;数值用于解释判断,不是新增线上或模型实测。先独立回答,再核对下面的推理。
展开推理、取舍与排错路径
客户端先发initialize请求,收到并核对版本能力后才发initialized通知,再开始正常操作。JSON-RPC请求有id并进入pending,通知无id不等响应;若等待通知回包就会人为挂住,响应还要按ID配对而非到达顺序。版本不支持应明确失败,不假装协商成功。
stdio以换行分隔UTF-8消息,诊断走stderr且及时排空;普通日志混入stdout会破坏协议。远端Streamable HTTP可能返回JSON或SSE,流事件与协议消息仍需正确分帧,代理缓冲、认证和Origin都影响行为。两种传输根据本地子进程或远端部署需求取舍,不把旧HTTP+SSE与新版自动视作兼容。断线先恢复协议状态并核对未决业务效果,不盲重放副作用;会话ID不是用户身份。面试给出状态序列和三个故障反例,比“重连重试”更完整。
课后练习展开习题收起习题
先独立作答,再展开参考思路。检查自己的解释是否包含机制、条件和反例。
initialized通知何时发送?
参考思路与常见误区
客户端收到并核对initialize响应后发送,随后才进入正常操作。
常见误区:请求刚发出就认为握手完成。
为何通知不应等待响应?
参考思路与常见误区
JSON-RPC通知没有id且不期待响应,等待会造成无谓阻塞。
常见误区:所有消息都按请求处理。
stdio日志为何放stderr?
参考思路与常见误区
stdout承载协议消息,普通日志会破坏解析;stderr也要妥善读取避免管道阻塞。
常见误区:把启动日志混入协议流。
断线后能重放所有请求吗?
参考思路与常见误区
不能,副作用可能已提交,先恢复协议状态并按业务ID确认结果。
常见误区:连接断了就当所有操作失败。
会话ID能作为认证凭证吗?
参考思路与常见误区
不能把会话定位等同用户认证,仍需按规范和服务策略验证身份权限。
常见误区:知道会话ID就可访问结果。