Network Lab

A Model Context Protocol (MCP) server for interacting with network devices. This lab demonstrates how to build an MCP server that connects to Cisco IOS-XE devices using Scrapli.

Video Series

This lab accompanies the video series available at: https://youtu.be/DlSJgTCUCDk

Features

• Execute show commands on network devices
• List available devices in the lab inventory
• Async SSH connections using Scrapli

Setup

1. Clone the repository
2. Install dependencies using uv:

   uv sync
   

3. Create a .env file with your device credentials:

   LAB_USERNAME=your_username
   LAB_PASSWORD=your_password
   

4. Update the device inventory in server.py with your device IPs

Usage

Run the MCP server:

uv run server.py

Project Structure

• server.py - Main MCP server with network tools
• network-mcp/ - Package directory
• pyproject.toml - Project configuration

Requirements

• Python 3.13+
• Network devices accessible via SSH