Network AI Assistant

Asynchronous MCP (Model Context Protocol) server for unified multi-platform network infrastructure management.

Expose network devices, WiFi controllers, monitoring systems, and data centers through a unified API accessible by Claude Desktop, Warp AI, and any MCP-compatible client.

Key Features

100% Asynchronous Architecture

• Async/await engine: All I/O operations leverage asyncio, asyncssh, and httpx for optimal performance
• Parallel execution: Native support for multi-device operations with timeout protection
• Persistent sessions: Reusable HTTP connections with keepalive to minimize latency
• Smart JWT caching: Thread-safe authentication token management with automatic renewal

10 Specialized Connectors

| Connector | Type | MCP Tools | Description | |-----------|------|-----------|-------------| | Generic SSH | SSH | 2 | Universal CLI access to any SSH device (Cisco, Juniper, Arista, Linux, etc.) | | MikroTik REST | REST API | 9 | Complete management via REST API (interfaces, BGP, routing, system health) | | MikroTik SSH | SSH | 2 | Specific commands unavailable in REST (route check, custom commands) | | Palo Alto SSH | SSH PTY | 2 | PAN-OS firewalls with PTY interactive sessions (VPN, routing, system) | | Palo Alto Panorama | REST API | 16 | Panorama centralized management (devices, device-groups, security rules, compliance, audit) | | Aruba WiFi | REST API | 9 | WiFi controller (APs, clients, rogues, RF, WLANs, statistics) | | Graylog | REST API | 3 | Centralized log search with time filters and streaming | | LibreNMS | REST API | 10 | Network monitoring (inventory, health, ports, sensors, events) | | Cisco APIC (ACI) | REST API | 28 | ACI data center (fabric, tenants, EPGs, VRFs, contracts, topology, analytics) | | Cisco NDFC | REST API | 14 | Nexus Dashboard Fabric Controller (fabrics, switches, networks, VRFs, events) |

Total: 97 MCP tools (95 connectors + 2 skills tools)

Installation

Prerequisites

• Python 3.12 or higher
• UV package manager
• Network access to target devices/APIs
• MCP client (Claude Desktop, Warp AI, etc.)

Install with UV

# Clone the repository
git clone https://github.com/angoran/git-netai.git
cd git-netai

# Sync dependencies (UV automatically creates virtual environment)
uv sync

# Verify installation
uv run python -c "from server import mcp; print(f'{mcp.name} operational')"

Configuration

Environment Variables

Create a .env file at project root with the following variables:

# Generic SSH
SSH_USERNAME="admin"
SSH_PASSWORD="your_password"

# MikroTik REST API
MIKROTIK_USERNAME="api_user"
MIKROTIK_PASSWORD="api_password"
MIKROTIK_PORT="443"

# MikroTik SSH (if different from REST)
MIKROTIK_SSH_USERNAME="ssh_user"
MIKROTIK_SSH_PASSWORD="ssh_password"
MIKROTIK_SSH_PORT="22"

# Palo Alto Firewalls
PALOALTO_SSH_USERNAME="admin"
PALOALTO_SSH_PASSWORD="firewall_password"

# Aruba WiFi Controller
ARUBA_IP="10.x.x.x"
ARUBA_USERNAME="admin"
ARUBA_PASSWORD="aruba_password"

# Graylog
GRAYLOG_API_URL="https://graylog.example.com"
GRAYLOG_USERNAME="graylog_user"
GRAYLOG_PASSWORD="graylog_password"

# LibreNMS
LIBRENMS_URL="https://librenms.example.com"
LIBRENMS_API_TOKEN="your_api_token_here"

# Cisco APIC (ACI)
APIC_HOST="https://apic.example.com"
APIC_USERNAME="apic_user"
APIC_PASSWORD="apic_password"
APIC_VERIFY_SSL="false"
APIC_TIMEOUT="30"
APIC_TOKEN_CACHE_DURATION="3540"

# Cisco NDFC
NDFC_HOST="https://ndfc.example.com"
NDFC

... [View full README on GitHub](https://github.com/angoran/git-netai#readme)