EC

e-conners-lab/first_mcp_server

Developer tools
6 stars 3 forks Quality 31 Trend 14

Build your first MCP server for network devices. Companion lab for The Tech-E video series: Cisco IOS-XE over Scrapli, consumed by Claude.

Overview

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. This lab accompanies the video series available at: https://youtu.be/DlSJgTCUCDk - Execute show commands on network devices - List available devices in the lab inventory - Async SSH connections using Scrapli 1. Clone the repository 2. Install dependencies using uv: 3. Create a .env file with your device credentials: 4. Update the device inventory in server.py with your device IPs - server.py - Main MCP server with network tools - network-mcp/ - Package directory - pyproject.toml - Project configuration - Python 3.13+ - Network devices accessible via SSH

README

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
View the full README on GitHub

Install

This server does not publish a one-line install command.

Open the repository installation guide New to MCP? Start with the mcpskill.org guide →