MCP Nvd

🚀 項目文檔

本項目基於Uvicorn和SSE，為NVD（國家漏洞數據庫）打造即時漏洞監控服務，藉助WebSocket協議與前端或其他客戶端即時通信，實現高效的漏洞管理與跟蹤。

🚀 快速開始

克隆項目

git clone https://github.com/your-username/mcp-nvd.git
cd mcp-nvd

安裝依賴

pip install -r requirements.txt

啟動服務

默認綁定地址為0.0.0.0:9090，使用SSE模式：

uvicorn mcp_nvd.main:app --host 0.0.0.0 --port 9090

訪問服務

• 測試接口：發送一條測試消息到指定端點。
• 即時數據流：通過WebSocket客戶端或支持SSE的瀏覽器連接，獲取即時數據。

✨ 主要特性

1. 即時數據傳輸：採用SSE技術，支持長時間保持連接，實現數據的即時推送。
2. 多平臺兼容性：支持同時運行HTTP和WebSocket兩種協議，滿足不同客戶端的需求。
3. 配置靈活：
   • 允許自定義綁定地址、端口號以及日誌記錄等級。
   • 支持設置每條消息的最大字節數（默認為無限制）。
4. 高效性能：基於Uvicorn的異步框架，處理高併發請求時表現優異。

📦 安裝指南

克隆項目

git clone https://github.com/your-username/mcp-nvd.git
cd mcp-nvd

安裝依賴

pip install -r requirements.txt

💻 使用示例

基礎用法

在main.py中可以通過以下方式配置服務器：

app = FastAPI(
    title="NVD漏洞監控服務",
    description="基於SSE的即時漏洞監控系統",
    version="1.0.0",
)

# 啟動命令示例：
uvicorn mcp_nvd.main:app --host 0.0.0.0 --port 9090

高級用法

以下是一個簡單的使用示例：

@app.websocket("/ws")
async def websocket_endpoint(websocket: WebSocket):
    await websocket.accept()
    try:
        while True:
            # 發送一條消息到指定端點
            await websocket.send_text("數據更新：{}".format(datetime.now()))
            await asyncio.sleep(1)
    except Exception as e:
        print(f"WebSocket連接關閉，錯誤：{e}")

📚 詳細文檔

配置選項

在main.py中可以通過以下方式配置服務器：

app = FastAPI(
    title="NVD漏洞監控服務",
    description="基於SSE的即時漏洞監控系統",
    version="1.0.0",
)

# 啟動命令示例：
uvicorn mcp_nvd.main:app --host 0.0.0.0 --port 9090

🔧 技術細節

本項目基於Uvicorn和SSE實現即時漏洞監控服務，通過WebSocket協議與前端或其他客戶端進行即時通信。Uvicorn作為異步服務器框架，能夠高效處理高併發請求；SSE技術則支持長時間保持連接，實現數據的即時推送。同時，項目支持HTTP和WebSocket兩種協議，具有良好的多平臺兼容性。

📄 項目結構

mcp-nvd/
├── mcp_nvd/          # 核心服務代碼
│   ├── main.py       # FastAPI應用入口
│   └── tools.py      # 輔助函數和配置項
├── requirements.txt  # 依賴管理文件
└── README.md         # 項目文檔

👥 貢獻者

• @your-username - 項目作者
• @contributor1 - 功能實現者

📝 致謝

感謝@sidharthrajaram為SSE基的MCP客戶端和服務器提供參考實現：https://github.com/sidharthrajaram/mcp-sse

⚠️ 注意事項

⚠️ 重要提示

請確保安裝所有必要的依賴項，包括fastapi、uvicorn和sseclient。本項目作為內部工具使用時需注意網絡安全，建議在生產環境中啟用HTTPS。

💡 使用建議

根據實際需求調整服務器配置，例如增加線程數或優化數據推送頻率。