Network MCP 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