MCP Netmiko

Clone the mcp-netmiko-server repository to your local machine and change into the project directory.

git clone https://github.com/upa/mcp-netmiko-server
cd mcp-netmiko-server

Define your network devices in a TOML file. The [default] section provides shared credentials inherited by all devices unless overridden. Each device section specifies a hostname and Netmiko device_type. See the Netmiko documentation for the full list of supported platform strings.

[default]
username = "admin"
password = "s3cr3tpassword"

[core-sw-01]
hostname = "192.168.1.1"
device_type = "cisco_ios"

[edge-router]
hostname = "10.0.0.254"
device_type = "juniper_junos"
username = "netops"
password = "juniper_pw"

Launch the server using uv, providing the path to your device TOML file as a positional argument. uv handles dependency installation automatically on first run.

uv run --with "mcp[cli]" --with netmiko main.py devices.toml

Add the server entry to claude_desktop_config.json. Replace the paths with absolute paths to main.py and your TOML file, since Claude Desktop does not inherit your shell's working directory.

{
  "mcpServers": {
    "netmiko": {
      "command": "uv",
      "args": [
        "run",
        "--with", "mcp[cli]",
        "--with", "netmiko",
        "/absolute/path/to/mcp-netmiko-server/main.py",
        "/absolute/path/to/devices.toml"
      ]
    }
  }
}

During development, run the server in SSE mode so you can inspect traffic in a browser or HTTP client before connecting your full MCP client.

uv run --with "mcp[cli]" --with netmiko main.py devices.toml --sse
# Server available at http://localhost:10000/sse