Which integrations are available for this server?

Allows AI assistants to interact with Cisco IOS-XE routers and switches to execute show commands, manage configuration changes, perform health checks, and handle configuration backups. Enables management and monitoring of Linux hosts, allowing for real-time health checks and command execution through natural language. Provides tools for interacting with Nokia SR Linux devices, enabling AI-driven command execution, configuration management, and network health monitoring.

How do I use network-mcp?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@network-mcp check the health of all my devices and list any down interfaces" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

network-mcp

by E-Conners-Lab

Overview Schema Source Related Servers Discussions Admin

Python

Hybrid

network-mcp

Give AI direct access to your network devices. 35 MCP tools, multi-vendor, one interface.

Stop writing Netmiko scripts. Connect Claude, ChatGPT, or any MCP-compatible AI to your routers, switches, and firewalls — and let it run show commands, check health, calculate subnets, discover topology, and manage configs through natural language.

You: "Check the health of all my devices"
Claude: [calls health_check_all] → 6 devices healthy, Switch-R2 has 2 interfaces down

What is this?

An MCP (Model Context Protocol) server that gives AI assistants real-time access to network devices. Built for network engineers who want to automate without writing boilerplate.

Supported platforms:

Cisco IOS-XE (routers, switches)
Nokia SR Linux
FRRouting (FRR)
Juniper Junos
Aruba AOS-CX
Linux hosts

Related MCP server: MCP-Telecom

Quick Start

1. Install

git clone https://github.com/E-Conners-Lab/MCP-DEMO-LAB.git
cd network-mcp
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt

2. Configure devices

cp .env.example .env
# Edit .env with your device IPs and credentials

3. Try it instantly (no lab required)

# Demo mode returns realistic mock data — no devices needed
DEMO_MODE=true python network_mcp_server.py

4. Connect to Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "network": {
      "command": "/path/to/network-mcp/.venv/bin/python",
      "args": ["/path/to/network-mcp/network_mcp_server.py"]
    }
  }
}

Restart Claude Desktop. You now have 35 network tools available.

5. Try with a real lab (5 minutes)

# Spin up 2 FRR routers with containerlab
cd quickstart && sudo containerlab deploy -t topology.clab.yml

Tools

Device Operations

Tool	Description
`get_devices`	List all devices in inventory
`send_command`	Run show commands on any device
`send_config`	Push configuration changes
`health_check`	Check device health (CPU, memory, interfaces)
`health_check_all`	Health check all devices in parallel
`backup_config`	Backup running configuration
`compare_configs`	Diff two config backups
`rollback_config`	Restore a previous config

Network Intelligence

Tool	Description
`discover_topology`	LLDP-based topology discovery
`get_routing_table`	View routing tables
`get_neighbors`	BGP/OSPF neighbor status
`get_arp_table`	ARP table lookup
`get_mac_table`	MAC address table
`ping_sweep`	Sweep a subnet for reachable hosts
`traceroute`	Trace path to destination

Calculators (no devices needed)

Tool	Description
`calculate_tunnel_mtu`	Optimal MTU/MSS for VPN tunnels
`calculate_subnet_info`	Subnet details from CIDR notation
`split_network`	VLSM subnet splitting
`convert_netmask`	CIDR to dotted decimal conversion

SNMP & Monitoring

Tool	Description
`snmp_get_oid`	SNMP GET for specific OIDs
`snmp_walk_oid`	SNMP WALK subtrees
`snmp_poll_metrics`	Poll interface/CPU/memory metrics

NETCONF

Tool	Description
`get_interfaces_netconf`	Interface data via NETCONF
`get_bgp_neighbors_netconf`	BGP state via NETCONF
`get_netconf_capabilities`	Device NETCONF capabilities

Configuration Management

Tool	Description
`compliance_check`	Check device against compliance templates
`full_network_test`	End-to-end network validation

See all 35 tools →

Architecture

┌─────────────────────────────────────────┐
│  AI Assistant (Claude, ChatGPT, etc.)   │
└────────────────┬────────────────────────┘
                 │ MCP Protocol (stdio/SSE)
┌────────────────▼────────────────────────┐
│  network_mcp_server.py                  │
│  FastMCP server + tool registry         │
└────────────────┬────────────────────────┘
                 │
┌────────────────▼────────────────────────┐
│  mcp_tools/                             │
│  ├── device.py      (9 tools)           │
│  ├── calculators.py (6 tools)           │
│  ├── topology.py    (6 tools)           │
│  ├── config.py      (8 tools)           │
│  ├── snmp.py        (5 tools)           │
│  ├── netconf.py     (4 tools)           │
│  ├── compliance.py  (7 tools)           │
│  └── ... (10 modules, 35 tools total)   │
└────────────────┬────────────────────────┘
                 │
┌────────────────▼────────────────────────┐
│  core/                                  │
│  ├── connection.py   (Netmiko/Scrapli)  │
│  ├── parser.py       (NTC/Genie)        │
│  ├── mtu_calculator.py                  │
│  └── subnet_calculator.py              │
└────────────────┬────────────────────────┘
                 │ SSH / NETCONF / SNMP
┌────────────────▼────────────────────────┐
│  Network Devices                        │
│  Cisco · Nokia · FRR · Juniper · Aruba  │
└─────────────────────────────────────────┘

Project Structure

network-mcp/
├── network_mcp_server.py    # MCP server entry point
├── config/
│   └── devices.py           # Device inventory (env var overrides)
├── mcp_tools/               # All MCP tool implementations
│   ├── device.py            # Core device operations
│   ├── calculators.py       # MTU/subnet calculators
│   ├── topology.py          # LLDP discovery
│   ├── config.py            # Config backup/compare/rollback
│   ├── snmp.py              # SNMP polling
│   ├── netconf.py           # NETCONF operations
│   ├── compliance.py        # Compliance checking
│   └── ...                  # 10 modules, 35 tools total
├── core/                    # Connection and parsing libraries
├── templates/               # Jinja2 config templates (FRR, IOS-XE)
├── quickstart/              # Containerlab quick-start lab
└── tests/                   # Test suite

Configuration

All configuration is via environment variables (or .env file):

# Device credentials
DEVICE_USERNAME=admin
DEVICE_PASSWORD=admin

# Device IPs (override defaults)
R1_HOST=10.255.255.11
R2_HOST=10.255.255.12

# Optional features
DEMO_MODE=true              # Mock data, no real devices
USE_NETBOX=true             # Pull inventory from NetBox
NETBOX_URL=http://localhost:8000
NETBOX_TOKEN=your-token

Requirements

Python 3.11+
Network devices reachable via SSH/NETCONF/SNMP
Claude Desktop or any MCP-compatible client

Contributing

See CONTRIBUTING.md for guidelines.

License

MIT License - see LICENSE for details.

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

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

Energy AT IT
com.energyatit.app
Protocol-native energy infrastructure orchestration for AI data centers. Provides 46 MCP tools across 8 grid protocols (IEC-61850, DNP3, Modbus, OCPP, OpenADR, IEEE 2030.5, IEC 60870-5-104, ICCP) with 5 core API primitives: connect, dispatch, settle, comply, and intel. Enables AI agents to programmatically interact with substations, grid interfaces, and energy assets for real-time workload-grid coordination.
Cloud Platforms Agent Orchestration Virtualization
2
mcp-serverOAuth
com.make
Give your AI agents the tools to build, manage, and run automation workflows.
App Automation Developer Tools Workplace & Productivity
2
mcpOAuth
com.vibgrate
Query your team's drift, vulnerability, and upgrade data from any AI assistant. OAuth 2.1, 51 tools.
Security Monitoring
2
emisarOAuth
dev.emisar
Let AI operate servers without SSH. Choose actions, approve risky changes, and audit every step.
Cloud Platforms Security Networking & Infrastructure
2335

Related MCP Servers

Network MCP Server
Networking & Infrastructure Shell Access
i-Nihal
F
license
Not graded
quality
D
maintenance
Enables AI agents to interact with Cisco IOS-XE network devices over SSH using structured tools. Provides read and write capabilities for network management with built-in validation and security.
Updated 5 months ago (2026-04-18 01:19 UTC)
-
MCP-Telecom
Networking & Infrastructure Command Line Monitoring
Avinash-Amudala
A
license
A
quality
C
maintenance
Bridges AI agents with network infrastructure, enabling secure read-only access to multiple vendor routers via SSH for natural language queries and troubleshooting.
Updated 5 months ago (2026-04-07 04:25 UTC)
58
1
MIT
NetContext MCP
Shell Access Networking & Infrastructure
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.
Updated 10 months ago (2025-11-20 06:32 UTC)
-
gnmi-mcp-server
Networking & Infrastructure Observability
Howthemeaning
F
license
Not graded
quality
B
maintenance
Enables AI assistants to manage network devices via gNMI protocol, including querying capabilities, reading/modifying configurations, and subscribing to telemetry data through natural language.
Updated 3 months ago (2026-07-03 09:23 UTC)
-

Appeared in Searches

Control Unity Router Configuration and Management

network-mcp

What is this?

Quick Start

1. Install

2. Configure devices

3. Try it instantly (no lab required)

4. Connect to Claude Desktop

5. Try with a real lab (5 minutes)

Tools

Device Operations

Network Intelligence

Calculators (no devices needed)

SNMP & Monitoring

NETCONF

Configuration Management

Architecture

Project Structure

Configuration

Requirements

Contributing

License

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

Network MCP Server

MCP-Telecom

NetContext MCP

gnmi-mcp-server

Appeared in Searches