用途:该技能面向审查或调试使用 mcp-use 包调用现有 MCP 服务器的 Python 代码,帮助区分 mcp-use 客户端 SDK 与 MCP 官方服务器 SDK、Claude Agent SDK、mcp-use 服务器 SDK 的不同职责。
主要能力:讲解 mcp-use 的定位(连接 LangChain LLM 与已有 MCP 服务器)、核心类(MCPClient、MCPAgent、MCPSession)、配置结构(mcpServers 下按 command/url/ws_url 自动识别传输类型)以及正确的异步生命周期。归纳六类常见误写:客户端与服务器 SDK 混淆、误用 @tool 装饰器、工具 schema 字段错误、缺失异步步骤、工具名格式不兼容、LangChain 新旧导入路径不匹配,并给出检测方式(grep)与修复方向。附带可核对的审查清单(RC-01 至 RC-22)和 mock 服务器单元测试示例。
使用方式:安装 pip install mcp-use。高层用 MCPAgent(llm=..., client=...) 后 await agent.run(query) 一站式完成连接、发现工具与运行;低层先 await client.create_all_sessions(),再 client.get_session(),然后 await session.list_tools() 和 await session.call_tool(name, args),最后 await client.close_all_sessions()。配置支持字典、JSON 文件路径及 from_dict/from_config_file 工厂方法。
适用场景:代码审查、调试 mcp-use 消费者代码、排查 LangChain 版本与异步错误。限制:资料未提供该技能的版本兼容范围、性能与收费信息;工具 schema 由服务器发现,消费者代码不应自行定义;遇点号工具名与 OpenAI 校验冲突时资料仅建议替换为下划线或更换 LLM 提供方,未给出完整方案。