# 🚀 VPN As A Service MCP

**🌐 Visit us at: [https://alexjef.net](https://alexjef.net)**

## ⚡ What's This?

Welcome to the cutting-edge AI-powered VPN orchestration layer! This MCP (Model Context Protocol) transforms how AI agents interact with VPN infrastructure. No more manual tunnel management – your AI can now seamlessly:

🔧 **Provision** VPN tunnels on-demand

🎛️ **Control** tunnel lifecycle (start/stop/status)

🌍 **Route** traffic through global endpoints

📊 **Monitor** connection health in real-time

## 🛠️ Installation & Setup

📦 Artifacts available in [Latest Release](https://gitlab.com/alexjef/ai_vpn_mcp/-/releases)

### 🐧 Linux (DEB/RPM)
```bash
# Grab the latest package from releases and install - dead simple!
sudo dpkg -i aivpn-mcp_*.deb  # Debian/Ubuntu
# OR
sudo rpm -i aivpn-mcp_*.rpm   # RHEL/Fedora/SUSE
```

### 🪟 Windows Power Users

**🔧 Prerequisites (Get these first):**
- **Python 3.9+** from [python.org](https://www.python.org/downloads/)
- **UV package manager:** `pip install uv`
- **WireGuard** from [wireguard.com](https://www.wireguard.com/install/)

**⚡ Installation Steps:**
1. Download `aivpn-mcp-xxx-generic.zip` from our releases
2. Extract to your preferred location (e.g., `C:\aivpn-mcp`)
3. Copy `example/mcp.json` to your working directory
4. **Critical:** Edit `mcp.json` and update the `directory` argument to your extraction path
5. 🚀 **Launch!** Your AI agent CLI will discover the MCP automatically

### 🍎 macOS Developers

**🔧 Prerequisites (Homebrew recommended):**
```bash
brew install python          # Python 3.9+
pip install uv              # UV package manager
brew install wireguard-tools # WireGuard CLI tools
```

**⚡ Installation Steps:**
1. Download `aivpn-mcp-xxx-generic.zip` from our releases
2. Extract to your preferred location (e.g., `/usr/local/aivpn-mcp`)
3. Copy `example/mcp.json` to your working directory
4. **Critical:** Edit `mcp.json` and update the `directory` argument to your extraction path
5. 🚀 **Launch!** Your AI agent CLI will discover the MCP automatically

---

**💡 Pro tip:** Visit [alexjef.net](https://alexjef.net) and [Support](https://t.me/alexjef_support) for advanced configuration, API documentation, and troubleshooting guides!