qucs-mcp

MCP server for Qucs/uSimmics circuit simulation. Enables MCP-compatible agents to generate circuit schematics, run simulations, and parse results programmatically.

What it does

This MCP exposes tools that lets agents:

• Build a Qucs schematic from component descriptions or KiCad files

• Run the Qucs backend simulator (simulator.exe) headlessly

• Parse the binary .dat result files into readable data

• Manage Qucs projects on disk

Related MCP server: ltspice-mcp

Prerequisites

• uSimmics installed (download the zip, extract anywhere)

• Python 3.11+ (managed by uv)

• uv: winget install astral-sh.uv or pip install uv

Setup

# Clone the repo
git clone https://github.com/leonardoAB1/qucs-mcp.git
cd qucs-mcp

# Install dependencies
uv sync

# Set the path to your uSimmics installation
$env:QUCS_HOME = "C:\Program Files\uSimmics"

# Verify the server starts
uv run qucs-mcp

Claude integration

Add to %APPDATA%\Claude\claude_desktop_config.json or .claude/settings.json in your project:

{
  "mcpServers": {
    "qucs-mcp": {
      "command": "uv",
      "args": ["--directory", "C:\\path\\to\\qucs-mcp", "run", "qucs-mcp"],
      "env": {
        "QUCS_HOME": "C:\\Program Files\\uSimmics"
      }
    }
  }
}

Environment variables

Available tools (Phase 1)

Example: voltage divider via MCP

Ask an agent (with this MCP enabled):

Create a voltage divider with R1=10k and R2=10k, supply 5V, sweep the supply from 0 to 10V in 11 steps, run the DC simulation, and tell me the midpoint voltage at each step.

The agent will call create_schematic then run_simulation then read_simulation_results and report the values.

Development

uv sync --extra dev
uv run pytest                          # unit tests
uv run pytest -k integration          # integration tests (requires QUCS_HOME)
uv run ruff check src/
uv run mypy src/
uv run mcp dev src/qucs_mcp/server.py  # open MCP Inspector in browser

Roadmap

• Phase 2: KiCad schematic import (parse_kicad_schematic, kicad_to_qucs_schematic)

• Phase 3: Circuit image analysis (extract_circuit_from_image using Claude vision)

• Phase 4: AC, transient, S-parameter simulation support; result plotting

License

MIT