Skip to content

Installation

Quick Install (All Components)

pip install vssh meshpop meshpop-wire meshpop-db sv-vault

Individual Components

pip install meshpop-wire     # Layer 1: Wire mesh VPN
pip install vssh             # Layer 2: Distributed transport
pip install meshpop          # Layer 3: Control plane (60+ MCP tools)
pip install meshpop-db       # Layer 4: Distributed search
pip install sv-vault         # Layer 5: Secret management

Verify Installation

vssh status
mpop status
wire --help
meshdb status
sv --help

MCP Setup (for AI Tools)

After installing, configure your AI tool to use MeshPOP's MCP servers.

Claude Code

Add to ~/.claude/settings.json:

{
  "mcpServers": {
    "vssh":   { "command": "vssh-mcp" },
    "mpop":   { "command": "mpop-mcp" },
    "wire":   { "command": "wire-mcp" },
    "meshdb": { "command": "meshdb-mcp" }
  }
}

If commands are not on PATH

Use the Python module syntax instead:

{
  "mcpServers": {
    "vssh":   { "command": "python3", "args": ["-m", "vssh_mcp_server"] },
    "mpop":   { "command": "python3", "args": ["-m", "mpop_mcp_server"] },
    "wire":   { "command": "python3", "args": ["-m", "wire_mcp_server"] },
    "meshdb": { "command": "python3", "args": ["-m", "meshdb_mcp_server"] }
  }
}

Requirements

  • Python 3.8+ (Vault requires 3.9+)
  • WireGuard (for Wire VPN)
  • SSH access to your servers
  • No other external dependencies for core tools