Skip to main content
Glama
ntunes

Netmiko MCP Server

by ntunes
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

Netmiko MCP Server

An MCP (Model Context Protocol) server for managing network devices via SSH using Netmiko. Features connection pooling, multi-vendor support, and concurrent operations.

Features

  • Command Execution: Run CLI commands on single or multiple devices

  • Configuration Management: Push configuration changes with optional save/rollback

  • Device Inventory: YAML-based device inventory with groups and tags

  • Connection Pooling: Efficient connection reuse with health checks

  • Multi-Vendor Support: Works with any device type supported by Netmiko

  • Concurrent Operations: Execute commands on multiple devices in parallel

  • TextFSM Parsing: Optional structured output parsing

Related MCP server: mcp-netmiko-server

Installation

From Source

git clone https://github.com/ntunes/netmiko-mcp-server.git
cd netmiko-mcp-server
pip install -e .

With Docker

docker build -t netmiko-mcp .

Configuration

Device Inventory

Create a config/devices.yaml file with your device inventory:

defaults:
  timeout: 30
  fast_cli: true

credentials:
  production:
    username: "${NETMIKO_USERNAME}"
    password: "${NETMIKO_PASSWORD}"
    secret: "${NETMIKO_SECRET}"

groups:
  core_routers:
    - core-rtr-01
    - core-rtr-02

devices:
  core-rtr-01:
    host: "192.168.1.1"
    device_type: "cisco_ios"
    credential_profile: "production"
    tags:
      - core
      - production

  core-rtr-02:
    host: "192.168.1.2"
    device_type: "cisco_ios"
    credential_profile: "production"
    tags:
      - core
      - production

pool_settings:
  max_connections_per_device: 3
  connection_timeout: 300
  health_check_interval: 60

Environment Variables

Set credentials via environment variables:

export NETMIKO_USERNAME="admin"
export NETMIKO_PASSWORD="your_password"
export NETMIKO_SECRET="enable_secret"

Optionally set config file location:

export NETMIKO_MCP_CONFIG="/path/to/devices.yaml"

Usage

Running the Server

Stdio transport (for Claude Desktop):

python -m netmiko_mcp

Streamable HTTP transport:

python -m netmiko_mcp --transport streamable-http --port 8339

With Docker:

docker run -p 8339:8339 \
  -e NETMIKO_USERNAME=admin \
  -e NETMIKO_PASSWORD=secret \
  -v ./config/devices.yaml:/app/config/devices.yaml:ro \
  netmiko-mcp

With Docker Compose:

# Set credentials in .env or environment
export NETMIKO_USERNAME=admin
export NETMIKO_PASSWORD=secret

docker-compose up -d

Claude Desktop Configuration

Add to your Claude Desktop configuration:

For stdio transport:

{
  "mcpServers": {
    "netmiko": {
      "command": "python",
      "args": ["-m", "netmiko_mcp", "--config", "/path/to/devices.yaml"]
    }
  }
}

For HTTP transport:

{
  "mcpServers": {
    "netmiko": {
      "url": "http://localhost:8339/mcp"
    }
  }
}

MCP Tools

Command Execution

Tool

Description

send_command

Execute a single command on one device

send_command_parallel

Execute the same command on multiple devices concurrently

send_commands_sequence

Execute multiple commands sequentially on one device

Configuration

Tool

Description

send_config

Push configuration commands to one device

send_config_parallel

Push configuration to multiple devices concurrently

Inventory & Discovery

Tool

Description

list_devices

List all devices with optional tag/type filtering

get_device_info

Get detailed device information and connection status

list_groups

List all device groups and their members

test_connection

Test connectivity to a device

get_pool_status

Get connection pool statistics

get_device_types

List all device types in inventory

get_tags

List all tags used across devices

Examples

Execute a command:

Use send_command on device "core-rtr-01" with command "show version"

Execute on multiple devices:

Use send_command_parallel on devices ["@core_routers"] with command "show ip interface brief"

Push configuration:

Use send_config on device "core-rtr-01" with config_commands ["interface Loopback0", "description Test"] and save_config true

Supported Device Types

Any device type supported by Netmiko, including:

  • cisco_ios - Cisco IOS

  • cisco_xe - Cisco IOS-XE

  • cisco_xr - Cisco IOS-XR

  • cisco_nxos - Cisco NX-OS

  • arista_eos - Arista EOS

  • juniper_junos - Juniper JunOS

  • paloalto_panos - Palo Alto PAN-OS

  • hp_procurve - HP ProCurve

  • linux - Linux SSH

See Netmiko supported platforms for the full list.

Development

Install Development Dependencies

pip install -e ".[dev]"

Run Tests

pytest

Run Linting

ruff check src/ tests/
mypy src/

License

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Netmiko MCP Server

    Owen123-lang
    F
    license
    Not graded
    quality
    D
    maintenance
    Enables interaction with Cisco network devices through SSH using Netmiko. Supports retrieving device status, interface details, configurations, and resource monitoring through natural language commands in Claude Desktop.
    -

  • NetPilot-MCP

    czgreg
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables large language models to manage network devices (Cisco, Huawei, H3C, Ruijie) via Telnet/SSH, supporting command execution, configuration, and diagnostics.
    12
    MIT

  • NetContext MCP

    hgursel
    F
    license
    Not graded
    quality
    D
    maintenance
    Enables AI assistants to execute SSH commands on network devices using natural language, supporting multiple vendors and authentication methods for automated network management.
    -