Sympathy-MCP

MCP server for Incus VM operations. Named for sympathetic magic — the connection between puppet and puppeteer.

Agents on masternode puppeteer VMs via structured MCP tools instead of freeform Bash commands.

Tools

Related MCP server: vlp-mcp-agent

Usage

# Run the MCP server (stdio transport)
uv run python -m sympathy_mcp

# Or via entry point
uv run sympathy-mcp

MCP Configuration

Add to .mcp.json:

{
  "mcpServers": {
    "sympathy-mcp": {
      "command": "uv",
      "args": ["run", "--project", "/path/to/Sympathy-MCP", "sympathy-mcp"]
    }
  }
}

Requirements

• Python 3.12+

• incus CLI installed and configured

• uv for project management

Architecture

• src/sympathy_mcp/incus.py — Async Incus CLI wrapper (validation, subprocess exec, structured results)

• src/sympathy_mcp/server.py — FastMCP server with 9 tools (stdio transport)

Shells out to incus CLI under the hood. Go rewrite planned.