Unimus MCP Server

A read-only server for the Unimus network configuration management system.

GitHub

Meet the Unimus MCP, symbolized by our LEGO parrot. Just as a parrot synthetically mimics human speech, this server allows you to "talk" to your Unimus network using natural language (LLMs). Ask a question about a backup, search for a specific configuration, or request the network topology; our parrot translates it into the correct, safe, read-only API calls.

This project is a read-only Model Context Protocol server for the Unimus network management platform. It exposes all your network data for conversational AI, making complex queries and analyses easier than ever.

📚 Documentation

📖 Complete Documentation - Visit Our Wiki

Quick Start

Docker (Recommended) 🐳

docker run -d \
  --name unimus-mcp \
  -e UNIMUS_URL="https://your-unimus.example.com" \
  -e UNIMUS_TOKEN="your-api-token" \
  -p 8080:8080 \
  controlaltautomate/unimus-mcp:latest

Python Installation

git clone https://github.com/Deployment-Team/unimus-mcp.git
cd unimus-mcp
pip install .

Current Version

Version: 1.0.0 (Production-Ready Enterprise Network Intelligence)

🎉 FULLY TESTED & VALIDATED: All 15 MCP tools tested against live Unimus instance

📦 Download Latest Release

Key Features

  • 15 MCP Tools: Complete device and backup management
  • Enhanced Metadata: 12 comprehensive calculated fields for device analysis
  • Flexible Attributes: Granular control over device data retrieval
  • Backup Content Search: Regex pattern matching in configurations
  • Network Topology: Device relationship analysis and topology mapping
  • Change Tracking: Find devices with recent configuration changes
  • Docker Ready: Enterprise-grade containerization with health checks
  • 100% Tested: Validated against live Unimus instances

Requirements

  • Python 3.10+
  • Unimus 1.7.x or newer (API v.2 support)
  • Valid Unimus API token with read permissions

Configuration

Set these environment variables:

  • UNIMUS_URL: Full URL to your Unimus instance
  • UNIMUS_TOKEN: API token from Unimus

Example Usage

> Show me all Cisco devices in my network
> Get the latest backup for device ID 15
> Search for "interface GigabitEthernet" in device backups
> Find devices that had backup changes in the last 24 hours
> Compare backup 100 with backup 105 and show differences

License

MIT License - see LICENSE for details.

Support

Related Servers