Unimus MCP Server

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

GitHub

Unimus MCP Mascot

Unimus MCP Server

Latest Release Docker Pulls License Python Version MCP Tools

GitHub Stars GitHub Issues Last Commit Unimus API

"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

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

संबंधित सर्वर