@zesun33/mcp-spice

Model Context Protocol (MCP) server for ngspice batch circuit simulation.

mcp-spice lets AI coding agents and IDEs (Cursor, Windsurf, GitHub Copilot / OpenAI Codex, Claude Code, Google Antigravity, OpenCode, Cline) run SPICE netlists with ngspice in batch mode and get .meas results back as JSON instead of plot windows or thousand-line logs.

One-step with the rest of the family:

npx @zesun33/create-hw-agent my-asic

Or this server alone after it is on npm:

npx -y @zesun33/mcp-spice

Tools Exposed

// Tool Call: spice_run {"netlist": "rc_lowpass.cir"}
{
  "success": true,
  "measurements": [{ "name": "vmid", "value": 0.63 }]
}

Execution Runtime

mcp-spice runs inside the zesun33/spice rootless Podman image.

Public install (recommended — anyone can pull):

podman pull ghcr.io/zesun33/spice:latest
export MCP_SPICE_IMAGE=ghcr.io/zesun33/spice

Local builds still work as localhost/zesun33/spice (the default). Override with MCP_SPICE_IMAGE. To force host binaries: export MCP_SPICE_RUNTIME=host.

Universal Client & AI IDE Setup

{
  "mcpServers": {
    "spice": {
      "command": "npx",
      "args": ["-y", "@zesun33/mcp-spice"],
      "env": { "MCP_SPICE_IMAGE": "ghcr.io/zesun33/spice" }
    }
  }
}

Until the package is on npm, point command at node and args at this repo's dist/index.js.

Verification & Testing

./scripts/verify.sh          # full, needs podman + spice image
./scripts/verify.sh --quick  # CI