ADK-Python项目中MCP会话重初始化导致的工具调用问题解析

问题背景

在ADK-Python项目中，当开发者使用MCP(Multi-Component Platform)服务器提供的工具集时，可能会遇到一个隐蔽但影响较大的问题。具体表现为：在MCP会话过期后重新初始化会话时，后续的工具调用会失败并抛出"'tuple' object has no attribute 'call_tool'"的错误。

问题本质分析

这个问题的根源在于会话重初始化过程中的类型处理不一致。在MCP会话管理器的实现中，create_session()方法返回的是一个元组(tuple)，包含两个元素：ClientSession对象和可选的异步子进程对象。然而，在会话重初始化函数_reinitialize_session()中，直接将这个元组赋值给了_mcp_session变量，而没有正确解包获取实际的会话对象。

技术细节

1. 错误实现：

async def _reinitialize_session(self):
    self._mcp_session = await self._mcp_session_manager.create_session()

2. 正确实现：

async def create_session(self) -> tuple[ClientSession, Optional[asyncio.subprocess.Process]]:

当开发者尝试调用call_tool方法时，实际上是在元组对象上调用，而非预期的ClientSession对象，因此导致了属性错误。

影响范围

这个问题主要影响以下场景：

• 使用MCPToolset并通过SSE(Server-Sent Events)建立连接的代理程序
• 长时间运行的应用，其中MCP会话可能因超时而需要重新初始化
• 需要多次调用MCP服务器工具的应用

解决方案

项目维护团队已经修复了这个问题，解决方案包括：

1. 正确解包create_session()返回的元组
2. 确保_mcp_session始终引用有效的ClientSession对象

开发者可以通过以下方式获取修复：

• 从项目主分支安装最新源代码
• 等待下一个正式版本发布

最佳实践建议

对于使用MCP工具集的开发者，建议：

1. 定期检查会话状态，避免在过期状态下操作
2. 实现适当的错误处理和重试机制
3. 考虑会话生命周期管理，特别是长时间运行的应用
4. 及时更新到包含此修复的版本

总结

这个问题展示了异步编程中类型处理的重要性，特别是在涉及会话管理和重连逻辑时。正确的类型处理和错误预防机制可以避免许多运行时问题。ADK-Python项目团队对此问题的快速响应也体现了开源社区对代码质量的重视。