3.Project setup

此文档由 学习AI的1000天 翻译制作(抖音，B站，YouTube)

邮箱: szqshan@gmail.com | 微信: szqshan
网址: www.xueai.org

==================================================

我们将构建一个基于CLI的聊天机器人，以便更好地理解MCP客户端和服务器如何协同工作。这个实践项目将为您提供MCP架构两端的实际操作经验。

我们要构建的内容

我们的聊天机器人将允许用户通过命令行界面与文档集合进行交互。该系统由两个主要组件构成：

• 处理用户交互的MCP客户端
• 管理文档操作的自定义MCP服务器

服务器将提供两个基本工具：一个用于读取文档内容，另一个用于更新文档。为简化起见，所有文档都将存储在内存中——无需数据库。

重要的架构说明

在实际项目中，您通常只实现MCP客户端或MCP服务器中的一个，而不是两者都实现。您可能会创建：

• 一个MCP服务器来向其他开发者公开您的服务
• 一个MCP客户端来连接现有的MCP服务器

我们在这个项目中构建这两个组件纯粹是出于教育目的——为了理解它们如何通信和协同工作。

Project Setup

下载本课程附带的 cli_project.zip 文件，并将其解压到您首选的开发目录中。在项目文件夹中打开您的代码编辑器。

该项目包含一个详细的 README 文件，其中包含设置说明。请按照以下步骤操作：

1. 将您的 Anthropic API 密钥添加到 .env 文件中
2. 使用 UV（推荐）或 pip 安装依赖项
3. 运行启动应用程序以验证一切正常工作

运行应用程序

在终端中导航到您的项目目录。您将看到主要的项目文件，包括 main.py、mcp_client.py 和 mcp_server.py。

要启动应用程序，请使用以下命令之一：

# 如果使用 UV（推荐）

uv run main.py

# 如果使用标准 Python

python main.py

当应用程序成功启动后，你会看到一个聊天提示符。通过询问一个简单的问题来测试它，比如"1+1等于多少？"——你应该能从 Claude 那里得到快速回复。

基础设置完成后，我们就可以开始实现 MCP 功能，并探索客户端和服务器如何通过 Model Control Protocol 进行通信了。

==================================================

此文档由 学习AI的1000天 翻译制作(抖音，B站，YouTube)
邮箱: szqshan@gmail.com | 微信: szqshan
网址: www.xueai.org