Ryan Malloy
50953a4dea
Wine batch-mode runner, binary .raw parser (UTF-16 LE + mixed precision float64/float32), .asc schematic parser/editor, and 9 FastMCP tools for simulation automation on Linux.
82 lines
1.9 KiB
Markdown
82 lines
1.9 KiB
Markdown
# mcp-ltspice
|
|
|
|
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 mcp-ltspice
|
|
|
|
# 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 mcp-ltspice -- uvx mcp-ltspice
|
|
```
|
|
|
|
Or for local development:
|
|
|
|
```bash
|
|
claude mcp add mcp-ltspice -- uv run --directory /path/to/mcp-ltspice mcp-ltspice
|
|
```
|
|
|
|
## License
|
|
|
|
MIT
|