# AI Network Troubleshooting MCP Server

A Python Model Context Protocol server that gives AI agents safe,
read-only network troubleshooting tools.

The project is designed for integration with Microsoft Copilot Studio
and Microsoft Teams.

## Features

- Device inventory
- Interface-status inspection
- VLAN-path diagnosis
- BGP-neighbor troubleshooting
- Longest-prefix route lookup
- Interface-error detection
- MCP Streamable HTTP transport
- Docker deployment
- Automated tests

## Architecture

Microsoft Teams user  
→ Copilot Studio agent  
→ Remote MCP server  
→ Network troubleshooting tools  
→ Mock or authorized lab devices

## MCP Tools

| Tool | Purpose |
|---|---|
| `get_device_inventory` | Lists available devices |
| `check_interface_status` | Returns interface status and VLAN data |
| `diagnose_vlan_path` | Detects access-to-trunk VLAN mismatches |
| `check_bgp_neighbor` | Diagnoses BGP neighbor state |
| `get_route` | Performs longest-prefix route lookup |
| `get_interface_errors` | Finds input and CRC errors |

## Local Setup

```bash
python -m venv .venv
.venv\Scripts\activate
pip install -r requirements-dev.txt