netsensei
solaconsay/netsenseiUpdated Apr 2000

Remote#network-administration#MCP#automationLicense: NoneLanguage: Python

NetSensei - MCP Server for Network Administration

NetSensei is an MCP server to assist network administrators. It provides various network utilities and tools such as ping, traceroute, Nmap scans, packet sniffing, and SSH using the Model Context Protocol (MCP) to communicate and process network-related commands.

Usage

You can use this with Claude Desktop or with OpenWebUI using mcpo

Features

  • Ping Test: Quickly test network connectivity with detailed output.
  • Traceroute: Identify the network path to any destination.
  • Nmap Scan: Perform network scans with customizable arguments to discover devices and services.
  • Packet Sniffer: Use tshark to capture and analyze network packets, filtered by custom criteria (e.g., DNS, HTTP, ICMP).
  • SSH connection: Connect to a device thru ssh and execute commands based on the device platform (e.g. Ubuntu Server, Cisco, Aruba, etc.).
  • AI Assistant: Leverage the power of AI to automate routine network tasks and gain deeper insights.

Requirements

  • Python 3.x
  • MCP Python SDK - https://github.com/modelcontextprotocol/python-sdk
  • uvicorn - ASGI server to run the FastAPI server.
  • tshark (Wireshark's command-line tool) must be installed and accessible from your system PATH.
  • nmap - For network scanning.
  • netmiko - For ssh connection.
  • A supported network interface (e.g., Wi-Fi, Ethernet) for packet sniffing.

Installation

  1. Clone this repository:

    git clone https://github.com/yourusername/netsensei.git
    cd netsensei
    
    
  2. Add this to your Claude Desktop config file.

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

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

Example

Prompting Claude AI to discover live host in a network.

▶️ Watch the demo video

alt text

Contribution

Contributions are welcome! Feel free to fork the repository, create an issue, or submit a pull request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Installation

Claude
Claude
Cursor
Cursor
Windsurf
Windsurf
Cline
Cline
Witsy
Witsy
Spin AI
Spin AI
Run locally with the following command:
Terminal
Add the following config to your client:
JSON
{
  "mcpServers": {
    "NetSensei": {
      "env": {},
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "C:\\path\\to\\cloned\\repo\\main.py"
      ],
      "command": "uv"
    }
  }
}

MCPLink

Seamless access to top MCP servers powering the future of AI integration.

© 2025 MCPLink. All rights reserved.
discordgithubdiscord