Skip to main content
Glama
JackG27

sheridan-lab-jack

by JackG27

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

-
security - not tested
F
license - not found
-
quality - not tested

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/JackG27/sheridan-lab-jack'

If you have feedback or need assistance with the MCP directory API, please join our Discord server