MCP Transport Prototype

🚀 mcp-transport-prototype

這是一個用於理解如何構建自定義MCP服務器的原型實現，該服務器可通過stdio和SSE傳輸協議進行訪問。本項目的核心目標在於深入理解SSE和stdio這兩種傳輸協議。

✨ 主要特性

• 支持通過SSE和stdio兩種傳輸協議訪問MCP服務器。
• 可用於理解SSE和stdio傳輸協議的工作原理。

🚀 快速開始

查看示例

mcp_client.py 是一個簡單的腳本，用於測試MCP服務器在SSE模式下的運行情況。

# 在終端1中運行
uv run main.py

# 在終端2中運行
uv run mcp_client.py

📚 詳細文檔

🔍 SSE 傳輸協議

服務器發送事件（Server-Sent Events，SSE） 是一種簡單高效的方式，用於通過HTTP將即時更新從服務器推送到客戶端。

• 與WebSocket不同，SSE是單向的：服務器可以向客戶端推送數據，但客戶端無法反向發送數據。
• 它運行在標準HTTP上，並且非常適合需要即時更新、通知或流式響應的場景。

⚠️ 重要提示

與stdio相比，SSE將MCP服務器作為單獨的HTTP服務運行。這使其非常適合用於Web儀表板或基於瀏覽器的應用程序，這些應用程序需要從服務器接收網絡上的即時更新。

🔍 Stdio 傳輸協議

Stdio（標準輸入輸出）是程序間通信的傳統方式，通過讀取來自終端、文件或其他程序的標準輸入（stdin），以及向終端、文件或其他程序發送標準輸出（stdout）來實現。

• stdin（標準輸入）：接收輸入數據 —— 通常來自鍵盤、文件或另一個程序。
• stdout（標準輸出）：發送輸出數據 —— 通常顯示在終端上，或通過管道傳遞給另一個程序。

⚠️ 重要提示

與SSE相比，基於Stdio的MCP服務器更像是內部工具。它們非常適合以子進程形式啟動MCP服務器，例如從命令行工具、大語言模型（LLM）代理或需要高效發送和接收結構化數據而無需使用網絡的背景腳本中使用。