客户端开发

开始构建您自己的客户端，该客户端可以与所有 MCP 服务器集成。

在本教程中，您将学习如何构建一个由 LLM 驱动的聊天机器人客户端，该客户端可以连接到 MCP 服务器。如果您已经完成了服务器快速入门，它将引导您完成构建第一个服务器的基础知识，这对您有所帮助。

Python

您可以在此处找到本教程的完整代码。

系统要求

在开始之前，请确保您的系统满足以下要求：

Mac 或 Windows 电脑

已安装最新 Python 版本

已安装最新版本的 uv

设置您的环境

首先，使用 uv 创建一个新的 Python 项目：

设置您的 API 密钥

您需要从 Anthropic 控制台获取 Anthropic API 密钥。

创建一个 .env 文件来存储它：

将您的密钥添加到 .env 文件：

将 .env 添加到您的 .gitignore：

请务必保护好您的 ANTHROPIC_API_KEY！

创建客户端

基本客户端结构

首先，让我们设置我们的导入并创建基本客户端类：

服务器连接管理

接下来，我们将实现连接到 MCP 服务器的方法：

查询处理逻辑

现在，让我们添加用于处理查询和处理工具调用的核心功能：

交互式聊天界面

现在，我们将添加聊天循环和清理功能：

主入口点

最后，我们将添加主执行逻辑：

您可以在此处找到完整的 client.py 文件。

关键组件解释

1. 客户端初始化

MCPClient 类使用会话管理和 API 客户端进行初始化

使用 AsyncExitStack 进行适当的资源管理

配置 Anthropic 客户端以进行 Claude 交互

2. 服务器连接

支持 Python 和 Node.js 服务器

验证服务器脚本类型

设置适当的通信通道

初始化会话并列出可用工具

3. 查询处理

维护对话上下文

处理 Claude 的响应和工具调用

管理 Claude 和工具之间的消息流

将结果组合成一个连贯的响应

4. 交互式界面

提供一个简单的命令行界面

处理用户输入并显示响应

包括基本的错误处理

允许正常退出

5. 资源管理

正确清理资源

错误处理连接问题

正常的关闭程序

常见的自定义点

工具处理

修改 process_query() 以处理特定工具类型

为工具调用添加自定义错误处理

实现特定于工具的响应格式

响应处理

自定义工具结果的格式化方式

添加响应过滤或转换

实现自定义日志记录

用户界面

添加 GUI 或 Web 界面

实现丰富的控制台输出

添加命令历史记录或自动完成

运行客户端

要使用任何 MCP 服务器运行您的客户端：

如果您正在继续服务器快速入门中的天气教程，您的命令可能如下所示：python client.py .../weather/src/weather/server.py

客户端将：

连接到指定的服务器

列出可用的工具

启动一个交互式聊天会话，您可以在其中：

输入查询

查看工具执行

获取 Claude 的响应

如果连接到服务器快速入门中的天气服务器，则它应如下所示：

工作原理

当您提交查询时：

客户端从服务器获取可用工具的列表

您的查询与工具描述一起发送给 Claude

Claude 决定要使用哪些工具（如果有）

客户端通过服务器执行任何请求的工具调用

结果被发送回 Claude

Claude 提供自然语言响应

响应将显示给您

最佳实践

错误处理

始终将工具调用包装在 try-catch 块中

提供有意义的错误消息

优雅地处理连接问题

资源管理

使用 AsyncExitStack 进行适当的清理

完成后关闭连接

处理服务器断开连接

安全

将 API 密钥安全地存储在 .env 中

验证服务器响应

对工具权限保持谨慎

故障排除

服务器路径问题

仔细检查您的服务器脚本路径是否正确

如果相对路径不起作用，请使用绝对路径

对于 Windows 用户，请确保在路径中使用正斜杠 (/) 或转义的反斜杠 ()

验证服务器文件是否具有正确的扩展名（Python 为 .py，Node.js 为 .js）

正确路径用法的示例：

响应时间

第一个响应可能需要长达 30 秒才能返回

这是正常的，并且发生在：

服务器初始化时

Claude 处理查询时

正在执行工具时

后续响应通常更快

在此初始等待期间不要中断该过程

常见错误消息

如果您看到：

FileNotFoundError：检查您的服务器路径

Connection refused：确保服务器正在运行并且路径正确

Tool execution failed：验证是否已设置该工具的所需环境变量

Timeout error：考虑增加客户端配置中的超时时间

Python#

系统要求#

设置您的环境#

设置您的 API 密钥#

创建客户端#

基本客户端结构#

服务器连接管理#

查询处理逻辑#

交互式聊天界面#

主入口点#

关键组件解释#

1. 客户端初始化#

2. 服务器连接#

3. 查询处理#

4. 交互式界面#

5. 资源管理#

常见的自定义点#

运行客户端#

工作原理#

最佳实践#

故障排除#

服务器路径问题#

响应时间#

常见错误消息#