Layer 3 — mpop (Control Plane)

Fleet manager for server meshes. Monitoring, deployment, security, AI diagnostics — all from one CLI with 60+ MCP tools.

Install

pip install meshpop

What It Does

mpop is the control plane for your server mesh. It uses vssh internally to talk to every node, and exposes everything as both CLI commands and MCP tools for AI integration.

CLI Categories

Monitoring

mpop status                          # Dashboard
mpop full                            # Comprehensive 9-table report
mpop servers                         # List all servers
mpop info myserver                   # Deep server details
mpop temp                            # CPU/GPU temperatures
mpop gpu                             # GPU VRAM, utilization
mpop services                        # Running services
mpop watch                           # Real-time monitoring
mpop trend --hours 24                # Historical trends
mpop matrix                          # Connectivity matrix
mpop diff server-a server-b          # Compare two servers

Security

mpop security                        # Firewall, fail2ban, ports, SSH
mpop audit myserver                  # Detailed security audit
mpop ssh-attacks                     # Attack patterns, top IPs

Execution

mpop exec myserver "df -h"          # Run command remotely
mpop exec "uptime"                   # Run on all servers
mpop python "print(1+1)" --server s  # Run Python remotely

Deployment

mpop deploy myapp                    # Push code to servers
mpop setup myserver                  # Install mpop/vssh on new server
mpop backup                          # Backup configs

AI Diagnostics

mpop heal myserver                   # Auto-detect and fix problems
mpop predict                         # Predict future issues
mpop ask "which server has low disk" # Natural language queries
mpop report                          # AI-generated status report
mpop dragon                          # Cold automated enforcement

Secrets

mpop secret list                     # List stored secrets
mpop secret get api_key              # Retrieve a secret
mpop secret set new_key              # Store a secret

MCP Tools (60+)

mpop exposes tools across these categories:

Category	Tools	Examples
Overview	5	`mpop_dashboard`, `mpop_servers`, `mpop_info`, `mpop_full`, `mpop_hw`
Monitoring	8	`mpop_temp`, `mpop_gpu`, `mpop_services`, `mpop_logs`, `mpop_watch`, `mpop_trend`, `mpop_matrix`, `mpop_diff`
Security	3	`mpop_security`, `mpop_audit`, `mpop_ssh_attacks`
Network	3	`mpop_vpn`, `mpop_peers`, `mpop_watchdog`
Execution	5	`mpop_exec`, `mpop_python`, `mpop_raw`, `mpop_delete`, `mpop_query_help`
File Ops	4	`mpop_read_file`, `mpop_write_file`, `mpop_chunk_write`, `mpop_scp`
NAS	5	`mpop_nas_ls`, `mpop_nas_read`, `mpop_nas_write`, `mpop_nas_backup`, `mpop_nas_usage`
AI & Diagnostics	8	`mpop_ai`, `mpop_heal`, `mpop_predict`, `mpop_advise`, `mpop_logai`, `mpop_report`, `mpop_roles`, `mpop_chain`
Config	4	`mpop_config`, `mpop_setup`, `mpop_deploy`, `mpop_backup`, `mpop_secret`
Agents	6	`mpop_agent_list`, `mpop_agent_make`, `mpop_agent_deploy`, `mpop_agent_run`, `mpop_agent_workflow`, `mpop_agent_chain`
Knowledge	4	`mpop_brain`, `mpop_project`, `mpop_memory`, `mpop_rag`
Integration	3	`mpop_notify`, `mpop_webhook`, `mpop_workflow`
Media	4	`mpop_tts`, `mpop_voice`, `mpop_news`, `mpop_export`
Router	1	`mpop_ask` (natural language → commands)

See MCP Tools Reference for full parameter details.

Source

meshpop/mpop — pip install meshpop