MCP Netmiko Server

🚀 mcp-netmiko-server

An MCP server that enables large language models to interact with your network devices via SSH (netmiko).

🚀 Quick Start

📦 Installation

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

# Create a device list file
vim my-devices.network.toml

# Run with standard input and output
uv run --with "mcp[cli]" --with netmiko main.py my-devices.network.toml

# Run in SSE server mode: URL is http://localhost:10000/sse
uv run --with "mcp[cli]" --with netmiko main.py my-devices.network.toml --sse

⚙️ Configuration

Define your network devices in the network device list file, for example, sample.network.toml:

[default]

username = "rouser"
password = "rouserpassword"

[qfx1]

hostname = "172.16.0.40"
device_type = "juniper_junos"

[nexus1]

hostname = "nexus1.lab"
device_type = "cisco_nxos"

[default] is a special section that defines default values such as username and password. Devices will inherit these default values if they are not defined in their configurations.

For device_type values, refer to Netmiko Supported Platforms.

📄 Claude Desktop Configuration JSON

{
  "mcpServers": {
    "netmiko server": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "--with",
        "netmiko",
        "[PATH TO]/mcp-netmiko-server/main.py",
        "[PATH TO]/YOUR-DEVICE.toml"
      ]
    }
  }
}