載入中
載入中

我們將建立自己的 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 伺服器。

我們的專案在單一程式碼庫中同時實作這兩個元件,純粹是出於教學目的,讓您能夠了解用戶端與伺服器之間如何互動。