我們將建立自己的 CLI 聊天機器人,以更深入了解 MCP 客戶端與伺服器如何協同運作。這個實作專案將讓您同時獲得 MCP 架構兩端的實務經驗。
我們要建立什麼
我們的聊天機器人將是一個命令列介面,讓使用者能夠與一組文件進行對話。以下是系統將包含的內容:
- 一個基於 CLI 的聊天機器人介面
- 讓 Claude 具備文件讀取與編輯能力
- 使用
@doc_name語法的文件「提及」功能 - 使用
/command_name語法執行命令 - 一組儲存在記憶體中的虛構文件集合

系統架構
本專案由三個主要元件協同運作組成:
- 我們的 MCP 客戶端 - 處理使用者互動與聊天介面
- 我們的 MCP 伺服器 - 提供文件操作相關工具
- 文件儲存 - 各種檔案類型的記憶體內集合

MCP 伺服器將實作兩個核心工具:
- 讀取文件內容的工具
- 更新文件內容的工具
所有文件(PDF、試算表、文字檔、Markdown 檔案)都將儲存在記憶體中,而非磁碟上,以保持專案的簡潔並聚焦於 MCP 概念。
重要架構說明
在實際專案中,您通常只會實作 MCP 客戶端或 MCP 伺服器其中之一,而不會同時實作兩者。您可能會:
- 建立一個 MCP 伺服器,將服務分發給其他開發者
- 建立一個 MCP 客戶端,連接到現有的第三方 MCP 伺服器

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