NetSensei

By solaconsay GitHub

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

netsensei network-administration

Overview

what is NetSensei?

NetSensei is an AI-powered network administration tool that acts as an MCP server to assist network administrators by providing various network utilities and tools such as ping, traceroute, Nmap scans, and packet sniffing.

how to use NetSensei?

To use NetSensei, you can integrate it with Claude Desktop or OpenWebUI using the MCP protocol. Follow the installation instructions to set it up and run the server.

key features of NetSensei?

Ping Test: Quickly test network connectivity with detailed output.
Traceroute: Identify the network path to any destination.
Nmap Scan: Perform customizable network scans to discover devices and services.
Packet Sniffer: Capture and analyze network packets using tshark.
AI Assistant: Automate routine network tasks and gain insights with AI.

use cases of NetSensei?

Monitoring network performance and connectivity.
Discovering devices and services on a network.
Analyzing network traffic for troubleshooting.
Automating routine network administration tasks.

FAQ from NetSensei?

What are the system requirements for NetSensei?

You need Python 3.x, MCP Python SDK, uvicorn, tshark, and nmap installed on your system.

Is NetSensei free to use?

Yes! NetSensei is open-source and available for free.

Can I contribute to NetSensei?

Absolutely! Contributions are welcome, and you can fork the repository to make improvements.

Content

NetSensei - MCP server Network Administration Assistant

NetSensei is an AI-powered network administration tool that acts as an MCP server to assist network administrators. It provides various network utilities and tools such as ping, traceroute, Nmap scans, and packet sniffing 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).
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.
A supported network interface (e.g., Wi-Fi, Ethernet) for packet sniffing.

Installation

Clone this repository:

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

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"
    ]
    }
}
}

Integrating with OpenWebUI

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

Example

Prompting Claude AI to discover live host in a network. 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.

No tools information available.

No content found.