Skip to main content

MCP server for network diagnostics — ping, DNS, port check, traceroute, speedtest, WoL, cert check, MAC lookup

Project description

mcp-nettools

MCP server for network diagnostics. Exposes 8 tools for use with Claude Code, Claude Desktop, or any MCP client.

Tools

Tool Description
ping ICMP ping — reachability and round-trip times
dns_lookup DNS record lookup (A, AAAA, MX, TXT, NS, CNAME)
port_check TCP port open/closed check
traceroute Network path tracing
speedtest Download/upload speed test via nearest server
wake_on_lan Send WoL magic packet to a MAC address
cert_check SSL certificate expiry, issuer, days remaining
mac_lookup MAC address OUI vendor lookup

Quick Start

uvx (no install required)

uvx mcp-nettools

Docker

docker run -i ghcr.io/aaronckj/mcp-nettools:latest

Claude Code

claude mcp add nettools -- uvx mcp-nettools

Claude Desktop

Add to ~/.config/claude/claude_desktop_config.json:

{
  "mcpServers": {
    "nettools": {
      "command": "uvx",
      "args": ["mcp-nettools"]
    }
  }
}

Or with Docker:

{
  "mcpServers": {
    "nettools": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "ghcr.io/aaronckj/mcp-nettools:latest"]
    }
  }
}

Requirements

For ping and traceroute tools, the server needs system binaries:

  • Linux: apt install iputils-ping traceroute
  • macOS: both are pre-installed
  • Docker: included in the image

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mcp_nettools-0.1.0.tar.gz (87.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mcp_nettools-0.1.0-py3-none-any.whl (3.9 kB view details)

Uploaded Python 3

File details

Details for the file mcp_nettools-0.1.0.tar.gz.

File metadata

  • Download URL: mcp_nettools-0.1.0.tar.gz
  • Upload date:
  • Size: 87.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for mcp_nettools-0.1.0.tar.gz
Algorithm Hash digest
SHA256 319c2de2aa293d3bba7c40a7f5e40ea337292e00f52157412e6aa320c7816908
MD5 72448ae89b3e930306408b89e6621f97
BLAKE2b-256 67f4f3c7684e41245f36ba31fad29c10fa00a60b30157e526a9094b5e3af138e

See more details on using hashes here.

Provenance

The following attestation bundles were made for mcp_nettools-0.1.0.tar.gz:

Publisher: publish.yml on aaronckj/mcp-nettools

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file mcp_nettools-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: mcp_nettools-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 3.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for mcp_nettools-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 1608bba7788ed15e318b6ccd1162f3d24debb34ac47d463924cd4a52cfa9db0a
MD5 5d1daad1178d13c81495f56d45d8a225
BLAKE2b-256 616a32a4d7a9fffaa9d30d61211a0643d3da6ac7fbff2115f0b0460041b93d58

See more details on using hashes here.

Provenance

The following attestation bundles were made for mcp_nettools-0.1.0-py3-none-any.whl:

Publisher: publish.yml on aaronckj/mcp-nettools

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page