MCP Server Com Sse E Autenticacao Bearer

該項目是一個基於TypeScript的MCP服務器實現，使用Server-Sent Events (SSE)進行即時消息傳輸，並通過Bearer Token進行安全認證。它支持與LLM主機等客戶端的即時通信，並提供了四個基礎數學工具作為示例。

通信工具開發者工具 #即時通信 #安全認證 #SSE傳輸 #MCP協議 .TypeScript

評分 : 2分

下載量 : 22

更新時間 : 2025-04-23

什麼是MCP Server?

MCP Server 是一個支持 Model Context Protocol 的即時通信工具，允許通過 SSE 協議傳輸消息，並通過 Bearer Token 實現安全認證。它適用於需要即時交互的應用場景，如 AI 工具集成。

如何使用MCP Server?

只需幾步即可完成設置和使用：安裝依賴、配置服務器、啟動服務。客戶端可以通過 SSE 連接併發送請求。

適用場景

適用於需要即時數據流的應用場景，例如 AI 助手、監控系統或協作工具。

主要功能

Server-Sent Events (SSE)支持通過 SSE 實現雙向即時通信。

Bearer Token 認證確保只有授權用戶可以訪問服務器。

工具註冊支持動態註冊和調用工具。

多端支持兼容多種客戶端設備和平臺。

優勢與侷限性

優勢

即時數據流傳輸

安全性高（Bearer Token）

易於擴展和集成

輕量級實現

侷限性

對網絡環境有一定要求

部分瀏覽器可能不完全支持 SSE

如何使用

克隆倉庫

使用 Git 克隆項目代碼到本地。

安裝依賴

運行 npm install 安裝所需依賴。

配置服務器

創建 .env 文件並填寫 BEARER_TOKEN 和 PORT 參數。

啟動服務

使用 npm run dev 啟動開發模式。

使用案例

案例 1: 數學運算工具使用 MCP Server 調用數學工具進行加法運算。

案例 2: 溫度轉換工具將攝氏度轉換為華氏度。

常見問題

如何確保連接的安全性？

是否支持多個客戶端同時連接？

如何調試 SSE 連接問題？

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

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

🚀 快速開始

開發環境搭建

克隆倉庫到本地：
```
git clone [倉庫地址]
cd mcp-server
```
安裝依賴項：
```
npm install
```
啟動開發服務器：
```
npm run dev
```

生產環境部署

編譯項目：
```
npm run build
```
執行編譯後的文件：
```
node dist/index.js
```

✨ 主要特性

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

📚 詳細文檔

項目架構

核心模塊

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

系統流程

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