sheridan-lab-jack — Network MCP Server

A Model Context Protocol (MCP) server that exposes 6 network management tools for a Nokia SR Linux device running in ContainerLab. Designed to be used with Claude Code as the AI agent.

Architecture

┌──────────────┐      MCP (stdio)      ┌──────────────────┐      SSH       ┌──────────────┐
│  Claude Code │ ◄──────────────────► │  sheridan-lab-jack │ ◄──────────► │  Nokia SR    │
│  (AI Agent)  │                      │  (MCP Server)      │              │  Linux       │
└──────────────┘                      └──────────────────┘              │  (ContainerLab)│
                                                                        └──────────────┘

Tools (6 total)

Read Tools (5)

Tool	Description
`get_device_info`	Returns hostname, software version, chassis type, uptime
`get_interfaces`	Lists all interfaces with admin/oper state and IP addresses
`get_routes`	Shows the full routing table
`get_running_config`	Retrieves running configuration (full or by section)
`get_network_instances`	Lists all VRFs/network-instances and their interfaces

Write Tools (1)

Tool	Description
`configure_interface`	Sets IP address, admin state, and description on an interface

Prerequisites

Linux (Ubuntu 20.04+ recommended)
Docker (20.10+)
ContainerLab (0.44+)
Python 3.10+
Claude Code CLI (requires Anthropic Pro subscription)
sshpass (sudo apt install sshpass)

Quick Start

1. Install ContainerLab

sudo bash -c "$(curl -sL https://get.containerlab.dev)"

2. Start the Lab

cd sheridan-lab-jack
sudo containerlab deploy --topo topology.yml

Wait ~60 seconds for SR Linux to fully boot. Verify with:

sudo docker ps  # should show clab-sheridan-lab-jack-srl running

3. Install Python Dependencies

pip install -r requirements.txt
sudo apt install sshpass -y

4. Test SSH Connectivity

sshpass -p 'NokiaSrl1!' ssh -o StrictHostKeyChecking=no admin@clab-sheridan-lab-jack-srl -- "info from state /system information"

5. Connect Claude Code

cd sheridan-lab-jack
claude

Claude Code automatically reads .mcp.json from the project directory. Once inside Claude Code, verify with:

> use get_device_info to check the device

Environment Variables

Variable	Default	Description
`DEVICE_HOST`	`clab-sheridan-lab-jack-srl`	Hostname or IP of the SR Linux container
`DEVICE_USERNAME`	`admin`	SSH username
`DEVICE_PASSWORD`	`NokiaSrl1!`	SSH password

Credentials are never hardcoded in the server code. They are read from environment variables at runtime and passed via .mcp.json.

Input Validation

All write tools validate inputs before execution:

IP addresses: Dotted-decimal regex validation
Prefix lengths: Range check (0-32)
Interface names: Pattern matching for SR Linux format (ethernet-X/Y, lo0, mgmt0, system0)
Hostnames: RFC-compliant alphanumeric + hyphens, 1-63 chars
Descriptions: Alphanumeric with basic punctuation, max 80 chars
Config section names: Alphanumeric and hyphens only

Cleanup

sudo containerlab destroy --topo topology.yml

Example Claude Code Session

You: get device info
Claude: [calls get_device_info] The device is a Nokia SR Linux running version...

You: show me all interfaces
Claude: [calls get_interfaces] Here are the interfaces...

You: configure ethernet-1/1 with IP 192.168.50.1/24 and description "uplink"
Claude: [calls configure_interface] Successfully configured ethernet-1/1...

You: verify the change by showing interfaces again
Claude: [calls get_interfaces] Confirmed — ethernet-1/1 now has IP 192.168.50.1/24...

License

MIT

sheridan-lab-jack