# mcltspice

MCP server for LTspice circuit simulation automation on Linux.

## Features

- **Run Simulations** - Execute .asc schematics or .cir netlists in batch mode
- **Extract Waveforms** - Parse binary .raw files to get voltage/current data
- **Modify Schematics** - Programmatically edit component values
- **Browse Libraries** - Access 6500+ symbols and 4000+ example circuits

## Requirements

- **Linux** with Wine installed
- **LTspice** extracted (see below)
- **Python 3.11+**

## Installation

```bash
# From PyPI (once published)
uvx mcltspice

# From source
uv pip install -e .
```

### LTspice Setup

Extract LTspice from the Windows MSI installer:

```bash
# Download LTspice64.msi from analog.com
cd /path/to/downloads
7z x LTspice64.msi -oltspice
cd ltspice
7z x disk1.cab

# Set up Wine prefix
export WINEPREFIX=$PWD/.wine
export WINEARCH=win64
wineboot --init
```

Set the `LTSPICE_DIR` environment variable or use the default `~/claude/ltspice/extracted/ltspice`.

## MCP Tools

| Tool | Description |
|------|-------------|
| `simulate` | Run simulation on .asc schematic |
| `simulate_netlist` | Run simulation on .cir netlist |
| `get_waveform` | Extract signal data from .raw file |
| `read_schematic` | Parse schematic components and nets |
| `edit_component` | Modify component values |
| `list_symbols` | Browse component symbol library |
| `list_examples` | Browse example circuits |
| `get_symbol_info` | Get symbol pins and attributes |
| `check_installation` | Verify LTspice setup |

## MCP Resources

- `ltspice://symbols` - All available component symbols
- `ltspice://examples` - All example circuits
- `ltspice://status` - Installation status

## Usage with Claude Code

```bash
claude mcp add mcltspice -- uvx mcltspice
```

Or for local development:

```bash
claude mcp add mcltspice -- uv run --directory /path/to/mcltspice mcltspice
```

## Repository

[git.supported.systems/MCP/mcltspice](https://git.supported.systems/MCP/mcltspice)

## License

MIT