MCP Server Com Sse E Autenticacao Bearer

🚀 基於SSE和Bearer認證的模型上下文協議服務器

本項目實現了一個MCP（Model Context Protocol）服務器，使用TypeScript語言開發。它藉助Server-Sent Events (SSE) 達成即時通信，利用Bearer Token進行身份驗證，項目結構清晰、功能模塊明確，能為用戶提供高效且安全的服務。

🚀 快速開始

開發環境搭建

1. 克隆倉庫到本地：

   git clone [倉庫地址]
   cd mcp-server
   

2. 安裝依賴項：

   npm install
   

3. 啟動開發服務器：

   npm run dev
   

生產環境部署

1. 編譯項目：

   npm run build
   

2. 執行編譯後的文件：

   node dist/index.js
   

✨ 主要特性

• 即時通信：採用SSE技術實現長輪詢，確保低延遲的消息傳遞。
• 身份認證：使用Bearer Token進行無狀態認證，提升安全性。
• 模塊化結構：各功能模塊獨立開發，便於維護和擴展。
• 可擴展性：支持添加新工具和服務，靈活適應不同需求。
• 高性能：基於Express框架，具備優秀的性能表現。
• 易用性：提供簡潔的API接口，便於集成和使用。

📚 詳細文檔

項目架構

核心模塊

• MCP Module：負責創建和配置MCP服務器實例，管理工具註冊及SSE連接。
• 中間件：提供Bearer Token認證、 CORS支持以及請求解析功能。
• 路由：實現了主要接口 /sse 和 /messages 的處理邏輯。
• 配置文件：定義服務器端口、會話過期時間等關鍵參數。
• 應用層：統籌各模塊協同工作，確保服務器正常運行。

系統流程

1. 建立連接：
   • 客戶端通過 GET /sse 請求與服務器建立SSE通道，並提供Bearer Token進行認證。
   • 服務器驗證Token後，創建新的SSE傳輸實例，併為客戶端分配唯一會話ID。
   • MCP服務器連接到SSE傳輸實例，初始化通信併發送工具列表等初始消息。
2. 消息處理：
   • 客戶端向 /messages 接口發送包含會話ID的消息請求。
   • 服務器根據會話ID查找對應的SSE傳輸實例，並將接收到的消息轉發給MCP服務器進行處理。
   • 處理完成後，響應結果通過SSE通道回傳給客戶端。
3. 斷開連接：
   • 當客戶端關閉SSE連接時，服務器檢測到狀態變化後，清理對應會話ID的傳輸實例。

項目依賴

• Node.js & npm：確保安裝最新穩定版本（推薦v14及以上）。
• ts-node：用於TypeScript文件的直接運行。
• @types/express：Express框架類型定義。
• express：基礎Web框架。
• ws：支持WebSocket通信。

序列圖

以下是項目的交互流程圖：

@startuml

title "基於SSE和Bearer認證的MCP服務器通信流程"

actor "MCP客戶端" as Client

participant "Express服務器" as Express
participant "Auth中間件" as Auth
participant "路由 /sse" as SSERoute
participant "SSE傳輸層" as SSE
participant "MCP服務器" as MCP
participant "路由 /messages" as MsgRoute

== 建立連接 ==
Client -> Express: GET /sse\n(Authorization: Bearer <token>)
Express -> Auth: 驗證Bearer Token
Auth -> Client: 200 OK
Client -> SSERoute: 建立SSE通道
SSERoute -> SSE: 創建傳輸實例
SSE -> MCP: 初始化連接

== 發送消息 ==
Client -> MsgRoute: POST /messages\n(會話ID)
MsgRoute -> SSE: 獲取傳輸實例
SSE -> MCP: 轉發消息
MCP -> SSE: 處理結果回傳
SSE -> Client: 接收響應

== 斷開連接 ==
Client -> SSE: 關閉通道
SSE -> SSERoute: 通知斷開
SSERoute -> Express: 清理資源

@enduml

🔮 未來展望

未來計劃增加以下功能：

1. 支持WebSocket協議以提升通信效率。
2. 實現消息隊列機制，提高系統吞吐量。
3. 添加日誌記錄與監控模塊，便於運維管理。