Metadata-Version: 2.1
Name: meshpop
Version: 4.10.2
Summary: MeshPOP - Manage all your servers from one terminal
Author-email: MeshPOP <mpop@mpop.dev>
License: MIT
Project-URL: Homepage, https://mpop.dev
Project-URL: Repository, https://github.com/meshpop/mpop
Project-URL: Documentation, https://mpop.dev/docs/
Keywords: devops,cli,server,management,ssh,mesh,mcp,wireguard,vpn
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: MacOS
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: System :: Systems Administration
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: pyyaml>=6.0
Requires-Dist: requests>=2.28
Requires-Dist: argon2-cffi>=21.0
Requires-Dist: cryptography>=3.4

# mpop — Manage All Your Servers From One Terminal

mpop is a single-command tool to monitor, manage, and secure multiple Linux servers. No agents to install manually, no YAML to write — just `pip install` and go.

```
pip install meshpop
mpop
```

That's it. mpop auto-detects your system, sets up a WireGuard VPN, and gives you a live dashboard.

## What It Looks Like

```
$ mpop

[OK] MeshPOP v4.9.9 | home | 5/5 online | 14:32:01 | LIVE

CONNECTIVITY
------------------------------------------
Node | VPN IP          | Status
------------------------------------------
home | 10.99.0.1       | << HERE
vps1 | 10.99.0.2       | ssh:+ vssh:+
vps2 | 10.99.0.3       | ssh:+ vssh:+
db1  | 10.99.0.4       | ssh:+ vssh:+
gpu1 | 10.99.0.5       | ssh:+ vssh:+

PERFORMANCE
--------------------------------------------------
Node | Load 1/5/15      | CPU  | Mem  | Disk
--------------------------------------------------
home |   0.42 0.38 0.31 | 12%  | 45%  |   62%
vps1 |   0.07 0.03 0.00 | 3%   | 39%  |   29%
vps2 |   1.21 0.98 0.87 | 34%  | 71%  |   55%
db1  |   0.15 0.12 0.09 | 8%   | 82%  |   44%
gpu1 |   2.34 2.11 1.95 | 89%  | 63%  |   37%
```

## Quick Start

### On your VPS (each server you want to manage):

```bash
pip install meshpop
mpop
```

The quickstart wizard runs automatically:
- Detects your system (OS, CPU, RAM, disk)
- Sets up WireGuard VPN
- Creates config
- Shows your dashboard

### On your computer (the machine you manage from):

```bash
pip install meshpop
mpop                          # choose "My computer"
mpop add vps1 YOUR_SERVER_IP  # adds server + auto VPN setup
```

mpop will ask for your SSH password, copy your key for future access, and establish a WireGuard tunnel — all automatically.

## Key Commands

| Command | What it does |
|---------|-------------|
| `mpop` | Live dashboard |
| `mpop add NAME IP` | Add a server to your mesh |
| `mpop info NODE` | Detailed server info |
| `mpop security` | Security overview (failed logins, open ports) |
| `mpop audit` | Deep security audit with attack logs |
| `mpop services` | Running services on each server |
| `mpop exec "CMD"` | Run a command on all servers |
| `mpop exec -t NODE "CMD"` | Run on specific server |
| `mpop logs NODE` | Real-time log streaming |
| `mpop heal` | Detect problems + suggest fixes |
| `mpop heal -x` | Auto-fix problems |
| `mpop predict` | Predict future issues (disk full, etc.) |
| `mpop setup NODE -x` | Full remote setup (mpop + vssh + agent) |
| `mpop help` | All commands |

## AI Integration

mpop includes a built-in MCP server that connects to Claude Desktop, Cursor, or any MCP client:

```bash
mpop mcp
```

This gives AI tools direct access to 50+ server management operations — dashboards, exec, security audits, log analysis, and more.

## How It Works

mpop creates a WireGuard mesh VPN between all your servers. All communication goes through encrypted tunnels on the `10.99.0.x` subnet. No ports exposed to the internet except WireGuard (UDP 51830).

```
Your Computer (10.99.0.1)
    |
    +-- WireGuard tunnel --> VPS 1 (10.99.0.2)
    +-- WireGuard tunnel --> VPS 2 (10.99.0.3)
    +-- WireGuard tunnel --> GPU box (10.99.0.4)
```

## Requirements

- Python 3.8+
- Linux or macOS
- WireGuard (auto-installed on Linux, `brew install wireguard-tools` on macOS)

## Links

- **Website:** [mpop.dev](https://mpop.dev)
- **PyPI:** [pypi.org/project/meshpop](https://pypi.org/project/meshpop/)
- **GitHub:** [github.com/meshpop/mpop](https://github.com/meshpop/mpop)

## License

MIT
