MCP Client 集成
本节定位
前面我们已经从 server 视角看了 MCP。
这一节换个方向，从 client 视角来看：
客户端怎样发现、选择并调用 MCP Server 的能力？
这一步很关键，因为真正用工具的往往不是 server，而是 client。
学习目标
- 理解 MCP Client 的核心职责
- 学会把“发现工具”和“调用工具”分成两步看
- 看 懂一个最小 MCP Client 调用流程
- 理解 client 侧为什么仍然需要选择策略、失败处理和缓存
一、Client 和 Server 的职责到底怎么分？
1.1 Server 提供能力
Server 更像“工具仓库管理员”，它负责：
- 列出工具
- 暴露能力
- 执行调用
1.2 Client 负责消费能力
Client 更像“真正来办事的人”，它负责：
- 发现工具
- 决定调用哪个
- 组织参数
- 接收结果
所以非常重要的一点是：
MCP Client 不是被动转发器，它通常仍然有自己的调用决策逻辑。
二、Client 最先要学会什么？先发现工具
2.1 为什么不能直接写死？
如果 client 一开始就把工具全写死：
- server 工具一变就要改代码
- 换一个 server 也要重写
这和 MCP 想解决的问题正好反着来。
2.2 一个最小发现示例
class MockMCPServer:
def list_tools(self):
return [
{"name": "search_docs", "description": "搜索课程文档"},
{"name": "get_weather", "description": "查询天气"}
]
server = MockMCPServer()
tools = server.list_tools()
for tool in tools:
print(tool)
2.3 这一步在教你什么？
它在教你：
client 先要知道“能用什么”，再谈“怎么用”。
这就是发现阶段的价值。
三、发现完以后，client 还要做什么？
3.1 选择工具
不是所有工具都要调。
客户端通常要先判断：
- 当前问题需不需要工具
- 如果需要，调哪个
3.2 组织参数
就算选对工具，也还要正确组织参数。
3.3 处理错误
如果：
- server 超时
- 工具不存在
- 参数校验失败
client 不能只崩掉，还要决定：
- 要不要重试
- 要不要降级
- 要不要换工具
四、一个最小 Client 示例
4.1 可运行代码
class MockMCPServer:
def list_tools(self):
return [
{"name": "search_docs", "description": "搜索课程文档"},
{"name": "get_weather", "description": "查询天气"}
]
def call_tool(self, name, arguments):
if name == "search_docs":
return {"result": f"检索结果: {arguments['query']}"}
if name == "get_weather":
return {"result": f"{arguments['city']} 当前晴天 22 度"}
return {"error": "unknown_tool"}
class MockMCPClient:
def __init__(self, server):
self.server = server
self.tools = []
def discover(self):
self.tools = self.server.list_tools()
return self.tools
def call(self, name, arguments):
return self.server.call_tool(name, arguments)
server = MockMCPServer()
client = MockMCPClient(server)
print(client.discover())
print(client.call("search_docs", {"query": "退款政策"}))
4.2 这段代码已经在说明什么？
它已经体现了 client 的两大主功能：
- 发现
- 调用
这就是 MCP Client 的最小闭环。
五、Client 其实还有“策略层”
5.1 为什么说 client 不只是协议调用器？
因为真实系统里，client 往往还要决定：
- 当前问题需不需要走 MCP
- 如果走，优先哪个 server / 哪个工具
- 失败后如何回退
5.2 一个简单工具选择器
def choose_tool(user_query, tools):
tool_names = [t["name"] for t in tools]
if "退款" in user_query and "search_docs" in tool_names:
return {"name": "search_docs", "arguments": {"query": "退款政策"}}
if "天气" in user_query and "get_weather" in tool_names:
return {"name": "get_weather", "arguments": {"city": "北京"}}
return None
tools = client.discover()
decision = choose_tool("退款政策是什么？", tools)
print(decision)
print(client.call(decision["name"], decision["arguments"]))
这说明 client 往往还承担一层轻量调度职责。
六、错误处理为什么对 client 特别重要？
6.1 因为 client 是“最先感知失败的一方”
server 那边可能返回：
- unknown_tool
- invalid_arguments
- timeout
而 client 必须决定接下来怎么做。
6.2 一个最小错误处理示例
def safe_call(client, name, arguments):
result = client.call(name, arguments)
if "error" in result:
return {"ok": False, "fallback": "当前工具不可用，请稍后重试。"}
return {"ok": True, "data": result["result"]}
print(safe_call(client, "search_docs", {"query": "退款政策"}))
print(safe_call(client, "bad_tool", {}))
这一步让系统从：
- “一错就崩”
变成：
- “一错也能兜住”
七、为什么有时 client 也需要缓存？
7.1 一个很现实的问题
如果你每次请求都重新 list_tools()，会不会浪费？
很多时候：
- 工具列表变化没那么频繁
- 每次重新发现会增加延迟
7.2 一个最小缓存思路
class CachedMCPClient(MockMCPClient):
def discover_once(self):
if not self.tools:
self.tools = self.server.list_tools()
return self.tools
cached_client = CachedMCPClient(server)
print(cached_client.discover_once())
print(cached_client.discover_once())
这虽然简单，但已经体现出：
client 也不只是“转发器”，它本身也有状态和优化空间。
八、Client 集成里最常见的坑
8.1 只会调，不会选
如果 client 不做选择策略，很容易：
- 工具虽多，但不会用
8.2 只看成功，不看失败路径
一旦 server 出错，系统体验就会突然变差。
8.3 每次都重新发现工具
可能会浪费很多不必要的开销。
小结
这一节最重要的不是写出一个能调 server 的类，而是理解：
MCP Client 的核心，不只是“发请求”，而是把“发现工具、选择工具、组织参数、处理结果”整成一个稳定消费层。
client 做得越成熟，server 侧的能力就越容易真正被上层系统利用。
练习
- 给
MockMCPServer再加一个read_file工具，然后扩展 client 选择逻辑。 - 想一想：为什么有些系统适合每次都重新发现工具，而有些适合做缓存？
- 给
safe_call()再加一个“出错后重试一次”的逻辑。 - 用自己的话解释：为什么说 MCP Client 通常还要有“策略层”？