A Simple MCP Server And Client

🚀 一個簡單的 MCP 服務器和客戶端

本項目是一個簡單的 Model Context Protocol (MCP) 服務器和客戶端實現，旨在演示如何暴露和訪問天氣信息，為開發者提供了一個清晰的示例來理解和運用 MCP 相關功能。

🚀 快速開始

啟動客戶端

node client.js

啟動客戶端時會自動啟動服務器作為子進程。客戶端將連接到服務器並執行所有示例操作。

獨立啟動服務器

node server.js

✨ 主要特性

服務器特性

• 資源豐富：提供多個城市的基本信息，包括 city://NewYork（紐約市）、city://London（倫敦市）和 city://Tokyo（東京市）。
• 工具實用：具備 get-weather 工具，可獲取某個城市的天氣預報，支持城市名稱和天數作為參數。
• 提示貼心：提供 weather-advice 提示，能根據天氣狀況獲取旅行建議。

客戶端特性

• 功能全面：演示了連接到 MCP 服務器、列出可用資源、讀取特定城市資源、調用天氣預報工具以及獲取天氣提示信息等操作。

通信特性

• 協議標準：使用 JSON-RPC 2.0 作為客戶端和服務器之間的底層通信協議。
• 概念清晰：涉及標準方法名稱（如 resources/list、resources/read、tools/call 和 prompts/get）、參數、請求標識符以及結果/錯誤等關鍵概念。

傳輸特性

• 機制簡單：使用 stdio（標準輸入/輸出）作為客戶端和服務器之間的傳輸機制。
• 日誌友好：實現了自定義日誌記錄傳輸，將客戶端和服務器之間交換的消息以人類可讀的格式記錄到控制檯，便於理解協議。

💻 使用示例

基礎用法

客戶端啟動並自動連接服務器執行示例操作：

node client.js

高級用法

獨立啟動服務器：

node server.js

🔧 技術細節

JSON-RPC 通信

此實現使用 JSON-RPC 2.0 作為底層通信協議，關鍵概念包括：

• 方法：標準方法名稱，如 resources/list 用於列出可用資源，resources/read 用於讀取特定資源，tools/call 用於調用工具，prompts/get 用於獲取提示信息。
• 參數：隨方法調用發送的輸入數據，例如在調用 get-weather 工具時，需要提供城市名稱和天數作為參數。
• 請求標識符：與響應匹配的唯一標識符，確保請求和響應的正確對應。
• 結果/錯誤：結構化響應數據或錯誤信息，方便客戶端處理。

傳輸機制

使用 stdio（標準輸入/輸出）作為客戶端和服務器之間的傳輸機制。客戶端啟動時會生成服務器作為子進程，並通過 stdin/stdout 流進行通信。同時，實現了自定義日誌記錄傳輸，將交換的消息以人類可讀的格式記錄到控制檯，有助於理解協議。

📚 詳細文檔

服務器資源

服務器工具

服務器提示

客戶端操作

客戶端在 client.js 文件中實現，演示了以下操作：

• 連接到 MCP 服務器
• 列出可用資源
• 讀取特定城市資源
• 調用天氣預報工具
• 獲取天氣提示信息

⚠️ 故障排除

如果遇到資源或提示請求超時的問題，請檢查服務器實現。示例中實現了直接消息處理以解決當前 SDK 版本的限制。