Netsensei

🚀 網絡先知 — 網絡管理的MCP服務器

網絡先知 是一款基於Model Context Protocol (MCP) 的服務器，專為網絡管理員打造。它集成了多種網絡實用工具和功能，像ping測試、路由跟蹤、Nmap掃描、包嗅探以及SSH連接等，可通過MCP協議進行通信，高效處理各類網絡相關命令，極大提升網絡管理效率。

🚀 快速開始

您可以通過Claude Desktop或結合mcpo使用OpenWebUI來使用本服務。

✨ 主要特性

• ping測試：能快速測試網絡連通性，並提供詳細輸出。
• 路由跟蹤：可精準識別到達目標的網絡路徑。
• Nmap掃描：支持執行自定義參數的網絡掃描，助力發現設備和服務。
• 包嗅探：藉助tshark捕獲和分析網絡數據包，還能根據自定義標準（如DNS、HTTP、ICMP）進行過濾。
• SSH連接：可通過ssh連接到設備，並執行基於設備平臺的命令（例如Ubuntu服務器、Cisco、Aruba等）。
• AI助手：藉助人工智能自動化常規網絡任務，提供更深入的洞察。

📦 安裝指南

環境要求

• Python 3.x
• MCP Python SDK - https://github.com/modelcontextprotocol/python-sdk
• uvicorn - 用於運行FastAPI服務器的ASGI服務器。
• tshark（Wireshark的命令行工具）：必須安裝並能從系統PATH訪問。
• nmap - 用於網絡掃描。
• netmiko - 用於ssh連接和命令執行。
• 支持的網絡接口（例如，Wi-Fi、以太網），用於數據包嗅探。

安裝步驟

1. 克隆此倉庫：

   git clone https://github.com/yourusername/netsensei.git
   cd netsensei
   

2. 將其添加到您的Claude Desktop配置文件中。

   {
       "mcpServers": {
           "NetSensei": {
               "command": "uv",
               "args": [
                   "run",
                   "--with",
                   "mcp[cli]",
                   "mcp",
                   "run",
                   "C:\\path\\to\\cloned\\repo\\main.py"
               ]
           }
       }
   }
   

3. 與OpenWebUI集成

   uvx mcpo --port 9003 -- mcp run main.py    
   

💻 使用示例

基礎用法

指示Claude AI發現網絡中的活躍主機。

▶️ 觀看演示視頻

🤝 貢獻

歡迎貢獻！您可以隨意叉取倉庫，創建問題或提交拉取請求。

📄 許可證

此項目根據MIT許可證授權 - 有關詳細信息，請參閱LICENSE文件。