# LTspice MCP Server

**Un servidor MCP (Model Context Protocol) que permite a los LLMs diseñar y simular circuitos electrónicos usando LTspice.**

Este proyecto conecta asistentes de IA (como Google Gemini) con LTspice XVII, permitiendo diseño de circuitos en lenguaje natural y simulación automática. Simplemente describí un circuito y la IA generará el netlist, lo simulará, detectará errores y los corregirá iterativamente hasta lograr una simulación exitosa.

---

## 🌟 Características

- 🔌 **Integración directa con LTspice** - Generación automática de netlists y simulación
- 🔄 **Auto-corrección** - Detecta y corrige errores comunes de SPICE (singular matrix, convergencia, etc.)
- 📚 **Búsqueda en biblioteca** - Valida componentes antes de simular
- 📁 **Organización automática** - Cada circuito se guarda en su propia carpeta con logs
- 🤖 **Diseño asistido por IA** - Compatible con cualquier LLM que soporte MCP

---

## 📋 Requisitos Previos

Necesitás tener instalado:

1. **Python 3.11+** - [Descargar](https://www.python.org/downloads/)
2. **uv** - [Guía de instalación](https://docs.astral.sh/uv/getting-started/installation/)
3. **LTspice XVII** - [Descargar de Analog Devices](https://www.analog.com/en/resources/design-tools-and-calculators/ltspice-simulator.html)
4. **Gemini CLI** - [Guía de instalación](https://github.com/google-gemini/generative-ai-cli)

**Sistema**: Windows 10/11

---

## 🚀 Instalación

### 1. Clonar el Repositorio

```bash
git clone https://github.com/luc-me/ltspiceMCP.git
cd ltspiceMCP
```

### 2. Instalar Dependencias

```bash
uv sync
```

### 3. Configurar Biblioteca de LTspice

Después de instalar LTspice, extraer la biblioteca de componentes:

1. Ir a `C:\Program Files\ADI\LTspice\` (o donde instalaste LTspice)
2. Buscar el archivo `lib.zip`
3. Extraerlo en `C:\Users\<TuUsuario>\Documents\LTspice\lib\`

### 4. Configurar Gemini CLI

Editar el archivo de configuración de Gemini CLI:

**Ubicación**: `C:\Users\<TuUsuario>\.gemini\settings.json`

Agregar en la sección `mcpServers`:

```json
{
  "mcpServers": {
    "ltspice-circuit": {
      "command": "uv",
      "args": ["run", "server.py"],
      "cwd": "C:\\ruta\\completa\\a\\ltspiceMCP",
      "env": {
        "PYTHONIOENCODING": "utf-8"
      }
    }
  }
}
```

**Importante**: Reemplazar la ruta con tu ubicación real del proyecto.

### 5. Verificar

Ejecutar el script de verificación:

```bash
uv run install.py
```

---

## 💡 Ejemplos de Uso

Una vez configurado, podés usar lenguaje natural en Gemini CLI:

```
Diseñame un filtro pasa-bajos RC con frecuencia de corte de 1kHz.
Usá un capacitor de 10nF y calculá el resistor.
```

```
Creá un amplificador emisor común con un transistor BC547.
Tensión de alimentación: 12V, resistor de carga: 2.2kΩ.
```

La IA automáticamente:
1. Buscará componentes disponibles
2. Generará el netlist
3. Simulará el circuito
4. Intentará corregir errores si los hay
5. Guardará todo en `circuitos/<nombre_proyecto>/`

---

## 🔧 Configuración

### Ruta Personalizada de LTspice

Si LTspice está en otra ubicación, editar en `server.py`:

```python
LTSPICE_EXE = r"C:\Tu\Ruta\LTspice.exe"
```

### Ruta Personalizada de Biblioteca

```python
LTSPICE_LIB_PATH = os.path.expanduser(r"~\Tu\Ruta\lib")
```

---

## 🐛 Solución de Problemas

### "LTspice.exe no encontrado"
- Verificar que LTspice esté instalado
- Revisar la ruta en `server.py`
- Ejecutar `install.py` para auto-detectar la ruta

### "Componente no encontrado"
- Asegurar que `lib.zip` esté extraído en `Documents\LTspice\lib\`
- La IA sugerirá automáticamente alternativas genéricas

### "Singular Matrix" o "Time step too small"
- Son errores de SPICE que la IA corrige automáticamente (hasta 3 intentos)
- Revisar el archivo `.log` en la carpeta del circuito para más detalles

### El servidor MCP no se conecta
1. Verificar que Gemini CLI esté instalado correctamente
2. Revisar que `settings.json` tenga la ruta correcta
3. Asegurar que `uv` esté en el PATH del sistema
4. Reiniciar Gemini CLI después de cambios

---