JinDaGe - netsensei MCP Details

article

README

🚀 网络先知 — 网络管理的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、以太网），用于数据包嗅探。

安装步骤

克隆此仓库：

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

将其添加到您的Claude Desktop配置文件中。

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

与OpenWebUI集成

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

💻 使用示例

基础用法

指示Claude AI发现网络中的活跃主机。

▶️ 观看演示视频

alt text

🤝 贡献

欢迎贡献！您可以随意叉取仓库，创建问题或提交拉取请求。

📄 许可证

此项目根据MIT许可证授权 - 有关详细信息，请参阅LICENSE文件。

netsensei