Ryan Malloy
cf8394fa6f
Rename package from mcp-ltspice/mcp_ltspice to mcltspice throughout: source directory, imports, pyproject.toml, tests, and README. Remove startup banner prints from main() since FastMCP handles its own banner and stdout is the MCP JSON-RPC transport. Point repo URL at git.supported.systems/MCP/mcltspice.
86 lines
1.9 KiB
Markdown
86 lines
1.9 KiB
Markdown
# 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
|