加载中
加载中

我们将构建自己的基于CLI的聊天机器人,以更好地理解MCP客户端和服务器如何协同工作。这个动手项目将让您在MCP架构的两端都获得实践经验。

我们要构建什么

我们的聊天机器人将是一个命令行界面,允许用户与一组文档进行聊天。以下是该系统将包含的内容:

  • 一个基于CLI的聊天机器人界面
  • 面向Claude的文档读取和编辑功能
  • 使用@doc_name语法的文档"提及"功能
  • 使用/command_name语法的命令执行
  • 存储在内存中的一组虚拟文档

在提示中输入@会列出deposition.md、design.md、financials.md、outlook.md、plan.md和spec.md,全部标记为"Resource"。

系统架构

该项目由三个协同工作的主要组件构成:

  • 我们的MCP客户端 - 处理用户交互和聊天界面
  • 我们的MCP服务器 - 提供文档操作工具
  • 文档存储 - 各种文件类型的内存集合

我们的服务器持有我们的MCP客户端,它与我们的MCP服务器双向通信,后者的工具可以读取和更新四个文档。

MCP服务器将实现两个核心工具:

  • 读取文档内容的工具
  • 更新文档内容的工具

所有文档(PDF、电子表格、文本文件、markdown文件)都将存储在内存中而非磁盘上,从而使项目保持简洁并专注于MCP概念。

重要架构说明

在实际项目中,您通常只实现MCP客户端或MCP服务器之一——而不是两者都实现。您可能会:

  • 构建一个MCP服务器,向其他开发者分发服务
  • 构建一个MCP客户端,连接到现有的第三方MCP服务器

我们的服务器包含MCP客户端的示意图,该客户端与一个独立的MCP服务器进行双向连接。

我们的项目在单个代码库中同时实现了这两个组件,纯粹是出于教学目的,以便您能够看到客户端和服务器之间是如何相互交互的。