Unimus MCP Server

"Talk" to your network configurations as you would a colleague.

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

• Installation & Setup - Get started quickly
• Docker Deployment - Container deployment guide
• API Reference - All 15 MCP tools
• Usage Examples - Example queries and use cases
• Development & Roadmap - Contributing and roadmap

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

• Documentation: Visit Our Wiki
• Issues: GitHub Issues
• Discussions: GitHub Discussions