ops-mcp-server Project

Project Overview

The ops-mcp-server is an IT operations management solution for the AI era. It achieves intelligent IT operations through the seamless integration of the Multi-Agent Collaboration Protocol (MCP) and Large Language Models (LLMs). By leveraging the power of LLMs and MCP's distributed architecture, it transforms traditional IT operations into an AI-driven experience, enabling automated server monitoring, intelligent anomaly detection, and context-aware troubleshooting. The system acts as a bridge between human operators and complex IT infrastructure, providing natural language interaction for tasks ranging from routine maintenance to complex problem diagnosis, while maintaining enterprise-grade security and scalability.

Key Highlights

Real-time Monitoring: Continuous monitoring of system resources, services, and performance metrics
Automated Inspection: Scheduled and on-demand inspection of server health and security status
Multi-vendor Support: Compatible with various network device vendors including Cisco, Huawei, and H3C
Container-ready: Built-in Docker container management and monitoring capabilities
Security-focused: Integrated security scanning and risk assessment tools
Plugin System: Extensible plugin architecture for adding new monitoring and management capabilities

Demo Video

On Cherry Studio 演示动画

Features

Server Monitoring Tools

Get Memory Info: Get local server memory information
Remote Server Inspection: Perform remote server inspection including CPU, memory, disk and other modules
System Load Monitoring: Get system load information
Process Monitoring: Monitor remote server processes, return top resource-consuming processes
Service Status Check: Check running status of specified services
Network Interface Check: Check network interfaces and connection status
Log Analysis: Analyze error and warning messages in server log files
Configuration Backup: Backup important system configuration files
Security Vulnerability Scan: Perform basic security vulnerability scanning
SSH Login Risk Check: Check SSH login risks including failed attempts and suspicious IPs
Firewall Configuration Check: Check firewall configuration and open ports
OS Details: Get detailed operating system information

Container Management Tools

Docker Container List: List all Docker containers and their resource usage
Docker Image List: List all Docker images on the server
Docker Volume List: List all Docker volumes with size information
Container Logs: Retrieve logs from specified container
Container Stats: Monitor resource usage of containers
Docker Health Check: Check Docker service health status and information

Network Device Management Tools

Device Identification: Identify network device types and basic information, auto-detect vendor (Cisco, Huawei, H3C, etc.)
Switch Port Check: Check switch port status and configurations
Router Routes Check: Check router routing tables by protocol
Network Config Backup: Backup network device configurations
ACL Config Check: Check security ACL configurations and rules
VLAN Inspection: Check switch VLAN configurations and ports
Optical Module Detection: Check optical module status, power levels, temperature and other key metrics, supporting multiple vendors
Device Performance Monitoring: Monitor network device CPU, memory, temperature, interface traffic and buffer utilization

Additional Features

Tool Listing: List all available tools and their descriptions
Batch Operations: Support simultaneous inspection tasks across multiple devices

Installation

This project uses uv for Python dependency and virtual environment management.

1. Install uv

curl -LsSf https://astral.sh/uv/install.sh | sh

2. Create and activate virtual environment

uv venv .venv
source .venv/bin/activate  # Linux/macOS
# or
.\.venv\Scripts\activate   # Windows

3. Install project dependencies

Make sure you have Python 3.10 or higher installed, then use the following command to install project dependencies:

uv pip install -r requirements.txt

Note: Dependency information can be found in the pyproject.toml file.

MCP Server Configuration

To add this project as an MCP server, add the following configuration to your settings file:

"ops-mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "YOUR_PROJECT_PATH_HERE",  // Replace with your actual project path
        "run", 
        "server_monitor.py"
      ],
      "env": {},
      "disabled": true,
      "autoApprove": [
        "list_available_tools"
      ]
    },
"network_tools": {
      "command": "uv",
      "args": [
        "--directory",
        "YOUR_PROJECT_PATH_HERE",  // Replace with your actual project path
        "run",
        "network_tools.py"
      ],
      "env": {},
      "disabled": false,
      "autoApprove": []
    }

License

This project is licensed under the MIT License.

Notes

Ensure the remote server's SSH service is running properly and you have appropriate permissions.
Adjust parameters according to actual conditions when using tools.
The project is currently being improved...