MCP Server Learning

🚀 學習 MCP 協議

本項目聚焦於學習 MCP 協議，涵蓋待辦事項與學習要點，助你深入瞭解 MCP 協議的相關知識與實現方法。

📋 待辦事項

• 實現採樣方法：https://modelcontextprotocol.io/docs/concepts/sampling
• 實現根目錄。

📚 學習要點

傳輸方式

存在兩種傳輸方式：

• 通過 stdio：你需要提供一個服務器二進制文件的路徑，供客戶端使用。
• 通過 sse：你需要提供服務器的網絡地址。這種傳輸方式似乎更加通用，它允許服務器獨立於客戶端部署。

服務器搭建嘗試

原本想使用 fastify 搭建服務器，但無法使其與現有 SDK 配合使用。不過，這也是一個學習僅使用 Node.js 編寫服務器的好機會！

MCP 相關核心 primitives

• 資源：可以將其視為數據（如 PDF、數據庫記錄等），這些數據可用於根據用戶查詢塑造正確的響應。
• 提示：可將其視為有時在“提示到 x”流程中看到的文本框下方定義的提示語句。
• 工具：這些允許 LLM 代表用戶執行操作。服務器負責調用工具並使用結果向客戶端做出響應，客戶端的任務是將這些結果傳遞給 LLM。
• 採樣：目前對這些還不是很確定。
• 根目錄：它們定義了服務器的“邊界”。例如，如果你的服務器暴露了一個與文件系統交互的工具，你可以通過在“根目錄”中包含特定目錄來將該工具“限制”在此目錄內。
• 傳輸方式：前面已提到，存在 STDIO 和 SSE 兩種傳輸方式。至於消息格式，則是基於 JSON - RPC 2.0 協議的。

SDK 錯誤處理

SDK 中內置了錯誤處理功能。如果在服務器 tool 回調函數中拋出一個錯誤，客戶端 SDK 將會處理該錯誤，並做出相應的響應。