【agent篇】Mcp易错点汇总

#安装 pip install langchain-mcp-adapters mcp1.顶层await报错#原代码 tools await client.get_tools()原因顶层 await 在独立脚本里跑不了。#修改后 async def main(): tools await client.get_tools()MultiServerMCPClient是异步的结果都是协程对象需要await2.from mcp.shared.exceptions import McpError导致的版本兼容问题#原代码 args: [ mcp-server-time, --local-timezoneAsia/Shanghai ]原因MCP Python SDK 在 2.0 版本里把 McpError 重命名成了 MCPError。而 mcp-server-time 这个 server 的源码还在用 v1 的 APIfrom mcp.shared.exceptions import McpError。uvx 默认装的是最新的 mcp 2.x于是 server 一启动就 ImportError 崩溃客户端这边就表现为 McpError: Connection closed。解决用 uvx 的 --with 参数把 mcp 锁回 1.x强制 uvx 解析到 McpError 仍然存在的版本#修改后 args: [ --with, mcp2, # ← 新增把 mcp SDK 锁回 1.x mcp-server-time, --local-timezoneAsia/Shanghai ]3.FastMcp.py 导入失败 导致 MCP server 启动即崩溃#原代码 from fastmcp import Fastmcp ← 错原因FastMcp.py 类名大小写错误FastMcp.py 导入失败 → MCP server 进程崩溃 → Conn_FastMcp.py 连接 stdio 时 Connection closed。#修改后 from fastmcp import FastMCP ← 对M、C、P 全大写