Skip to content
MCP server

Netexpert MCP

Read-only local network and security diagnostics: devices, DNS, WiFi, exposure

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, Windows, Linux
Runs
Locally
Version
0.1.3
Listing updated
today

Similar MCP servers

About Netexpert MCP

Netexpert MCP is an open-source MCP server for security. It runs locally on your machine and is started by your AI client.

Netexpert answers home-lab questions from one conversation: what is on my network, is my link healthy, is this machine exposed, and why is something slow. It runs locally on Windows, Linux or macOS, returns every result in one normalised JSON envelope and works with no configuration on first run.

Its 31 tools cover connectivity checks (ping, traceroute, HTTP timing, TLS certificates, bounded port scans), DNS lookups and a hijack check that compares the system resolver with trusted DNS-over-HTTPS, LAN inventory with vendor names from an IEEE OUI database and new-device alerts against saved snapshots, WiFi health interpretation, and host posture such as listening ports, firewall state and a risky-port exposure report.

Safety is built in. Port, host and byte caps and rate limits are enforced in code, subprocesses never go through a shell, and the only mutating tool, Wake-on-LAN, needs a dry-run plan and a single-use confirmation token. Deep scans through nmap are opt-in, restricted to private ranges, and nothing phones home.

Install

Run in a terminal

claude mcp add netexpert-mcp -- npx -y netexpert-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "netexpert-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "netexpert-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "netexpert-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "netexpert-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "netexpert-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "netexpert-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "netexpert-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "netexpert-mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "netexpert-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "netexpert-mcp"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • NETEXPERT_MCP_CONFIGPath to the config JSON (default: ~/.netexpert-mcp/config.json). Zero-config: every key is optional. See the README for the schema.
  • NETEXPERT_HTTP_PORTIf set (>0), also expose a stateless streamable HTTP transport at that port: POST /mcp (JSON-RPC) + GET /health. Loopback by default.
  • NETEXPERT_WIFI_IFLinux only: the wlan interface for iw-based WiFi status (default wlan0).

Tools this server provides (31)

Taken from the project documentation; the running server may differ.

net.health
Version, platform and capability matrix.
net.ping
ICMP loss and latency stats with a TCP fallback.
net.trace
Traceroute hops normalised across platforms.
net.httpcheck
HTTP check with timing split.
net.portcheck
Single TCP connect check.
net.portscan
Bounded connect scan.
net.ssl
TLS certificate details and expiry grade.
net.publicip
Public IPv4 with ASN and organisation.
net.deepscan
Optional opt-in nmap adapter for private ranges.
dns.lookup
DNS record lookups.
dns.reverse
Reverse DNS names for an IP.
dns.resolvers
Shows DNS servers the OS actually uses.
dns.propagation
Compares a record across resolvers.
dns.hijackcheck
Compares system resolver with trusted DoH.
lan.interfaces
Network interfaces.
lan.gateway
Default gateway and subnet.
lan.arp
Neighbour cache.
lan.sweep
Ping sweep of a private subnet.
lan.devices
Device inventory with vendor and hostname.
lan.hostname
Known names for an IP.
lan.snapshot
Save or list inventory snapshots.
lan.newdevices
Diff live devices against a baseline.
lan.wol
Wake-on-LAN with dry-run and confirmation.
wifi.status
Current WiFi link.
wifi.networks
Nearby access points.
wifi.health
Interprets WiFi quality.
sec.connections
Active sockets with owning process.
sec.listening
Listeners per process.
sec.firewall
Firewall state.
sec.exposure
Exposure report of listeners, firewall and risky ports.
sec.speedtest
Bounded download speed test.

What it does

Network inventory
Lists LAN devices with vendor names and flags new ones.
DNS hijack check
Compares system DNS answers with trusted DNS-over-HTTPS.
Exposure report
Combines listening ports, firewall state and risky ports.
WiFi health
Interprets signal, channel overlap and band mismatch.
Bounded scanning
Caps ports, hosts and rate in code.
Read-only default
The one mutating tool needs a dry-run and confirmation token.

Good for

  • Ask what devices are on your home network
  • Find out whether a machine exposes risky ports
  • Check whether your DNS is being tampered with
  • Diagnose slow WiFi with next steps

Pricing

Open source

Free; run locally from npm

Netexpert MCP FAQ

Does it need configuration?

No. The README says first run needs no config file or environment variables.

Can it change my network?

Only Wake-on-LAN changes anything, and it requires a dry-run plan and single-use confirmation token.

Does it send data anywhere?

No telemetry. Only three tools that are about the internet contact outside services when you invoke them.

Which platforms work?

Windows, Linux and macOS.

Is Netexpert MCP free?

Yes. Netexpert MCP is open source, so you can use and self-host it for free.

How do I add Netexpert MCP to Claude Code?

Run this command in your terminal: claude mcp add netexpert-mcp -- npx -y netexpert-mcp

What are the best alternatives to Netexpert MCP?

The closest alternatives to Netexpert MCP are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers