Project setup

学习笔记：MCP 客户端与服务器实现

一、项目目标与架构 (Project Goal & Architecture)

• 核心目标： 通过实现一个基于命令行（CLI）的聊天机器人，深入理解客户端（Client）和服务器（Server）的协作机制。
• 系统组成：
• CLI 聊天机器人： 用户交互界面。
• MCP 客户端： 连接到自定义 MCP 服务器的组件。
• 自定义 MCP 服务器： 包含特定功能的后端服务。
• 数据处理：
• 处理的是一组模拟文档（Fake Documents）。
• 文档数据仅存储在内存中（In Memory），不进行持久化存储。
• 服务器工具 (Tools)： 服务器内置两个工具：
• 读取文档内容 (Read Document)。
• 更新文档内容 (Update Document)。
• 项目意义： 本项目同时构建客户端和服务器，旨在提供一个完整的端到端示例，帮助学习者理解实际应用中两者是如何协同工作的。

二、项目设置流程 (Project Setup)

• 获取代码： 下载 CLIProject. zip 文件并解压。
• 阅读文档： 必须仔细阅读 README 文件中的设置指南。
• 环境配置：
• 配置环境变量，指定 Bedrock 区域（Region）和模型 ID（Model ID）。
• 这些配置应与之前使用的环境保持一致。
• 依赖安装：
• 设置 Python 环境。
• 安装必要的依赖包（Dependencies）。
• 运行项目：
• 在项目目录下运行启动命令。
• 运行命令示例：uv run main. py 或 python main. py。
• 成功运行后，应出现聊天提示符（Chat Prompt）。

Takeaways

• 项目核心目标是理解客户端（MCP Client）与自定义服务器的端到端协作机制。
• 系统数据（模拟文档）仅在内存中处理，不具备持久化存储功能。
• 服务器内置了两个关键工具：读取文档（Read Document）和更新文档（Update Document）。
• 运行项目前必须配置环境变量（指定Region和Model ID）并安装所有依赖包。