Project setup

📝 学习笔记：MCP 客户端与服务器项目

一、项目目标与概念 (Project Goal & Concepts)

• 核心目标：通过构建一个基于命令行（CLI）的聊天机器人，深入理解客户端（Client）和服务器（Server）的工作机制。
• 系统组成：
• CLI 聊天机器人：用户交互界面。
• MCP 客户端：负责连接和调用自定义的 MCP 服务器。
• 自定义 MCP 服务器：提供服务和功能。
• 服务器工具：本项目服务器包含两个核心工具：
• 读取文档内容（Read document content）。
• 更新文档内容（Update document content）。
• 数据存储：所有文档均为“假文档”，仅在内存中存储（非持久化）。

二、项目设计意图 (Project Scope & Intent)

• 常规项目模式：在实际项目中，通常只构建客户端或服务器中的一个。
• 本项目特殊性：本项目同时构建了客户端和服务器，目的是在一个项目中展示两者如何协同工作。

三、项目设置步骤 (Project Setup)

• 准备工作：
• 下载 CLI_project. zip 文件。
• 在项目目录下打开代码编辑器。
• 查阅 README. md 文件，获取详细的设置指南。
• 配置流程：
• 配置 API 密钥（API key）到 . env 文件中。
• 安装项目依赖（可使用 uv 或标准 Python）。
• 运行项目：
• 确保在项目根目录下执行命令。
• 使用 uv 运行：uv run main. py
• （若不使用 uv，则使用 python main. py）
• 预期结果：运行成功后，应出现聊天提示（chat prompt），并能快速响应简单的查询。

Takeaways

• 本项目核心目标是构建一个CLI聊天机器人，深入理解客户端（Client）与服务器（Server）的协同工作机制。
• 服务器包含读取文档内容和更新文档内容的两个核心工具，且所有文档数据仅在内存中存储（非持久化）。
• 本项目设计意图在于同时构建客户端和服务器，以展示两者在实际应用中的协作模式。
• 项目运行前需将API密钥配置到. env文件，并使用uv run main. py或python main. py启动程序。