Metadata-Version: 2.4
Name: mcp-nettools
Version: 0.1.0
Summary: MCP server for network diagnostics — ping, DNS, port check, traceroute, speedtest, WoL, cert check, MAC lookup
License: MIT
Keywords: diagnostics,homelab,mcp,networking
Classifier: Development Status :: 3 - Alpha
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: System :: Networking
Classifier: Topic :: System :: Systems Administration
Requires-Python: >=3.12
Requires-Dist: dnspython>=2.6
Requires-Dist: mac-vendor-lookup>=0.1.12
Requires-Dist: mcp>=1.0
Requires-Dist: speedtest-cli>=2.1
Requires-Dist: wakeonlan>=3.0
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
Requires-Dist: pytest-cov>=4.0; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Description-Content-Type: text/markdown

# 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)

```bash
uvx mcp-nettools
```

### Docker

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

### Claude Code

```bash
claude mcp add nettools -- uvx mcp-nettools
```

### Claude Desktop

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

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

Or with Docker:

```json
{
  "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
