Ltspice MCP (Xuio)

适用于macOS的LTspice MCP

模型上下文协议（MCP）服务器，允许代理和MCP客户端在macOS上控制LTspice，用于模拟、原理图生成、数据提取、验证和渲染。

该项目旨在实现实用的自动化：可靠的运行、可复制的工件和与LTspice行为紧密匹配的输出。

灵感来源：

• gtnoble/ngspice mcp
• luc me/its piceMCP

你能做什么

• 从MCP运行LTspice模拟(simulateNetlistFile, runSimulation，队列工具）。
• 生成并优化示意图(createSchematic*，lint/clean/debug工具）。
• 为原理图、绘图和符号渲染真实的LTspice图像。
• 查询RAW向量和分析指标（带宽、边距、上升/下降、稳定）。
• 自动化 .meas 以及断言驱动的验证工作流程。
• 使用结构化结果进行逐步和蒙特卡洛研究。

快速入门（5分钟）

1） 先决条件

• 安装了LTspice的macOS(/Applications/LTspice.app 默认情况下是预期的）。
• Python 3.11以上。
• uv （推荐）或 pip.

2） 安装

uv sync

如果你喜欢pip：

python3 -m venv .venv
source .venv/bin/activate
pip install -e .

3） 启动MCP守护进程

./scripts/ltspice_mcp_daemon.sh start
./scripts/ltspice_mcp_daemon.sh status

默认端点：

• http://127.0.0.1:8765/mcp

4） 授予macOS权限一次

需要截图/渲染和一些UI自动化功能。

./scripts/ltspice_mcp_daemon.sh trigger-initial-permissions
./scripts/ltspice_mcp_daemon.sh check-accessibility

5） 运行烟雾测试

uv run python smoke_test_mcp.py \
  --transport streamable-http \
  --server-url http://127.0.0.1:8765/mcp

客户端配置

支持URL的MCP客户端

[mcp_servers.ltspice]
url = "http://127.0.0.1:8765/mcp"
enabled = true

克劳德桌面通过 mcp-remote

{
  "mcpServers": {
    "ltspice-mcp": {
      "command": "/opt/homebrew/bin/npx",
      "args": ["-y", "mcp-remote", "http://127.0.0.1:8765/mcp"]
    }
  }
}

stdio （子流程）模式

{
  "mcpServers": {
    "ltspice-mcp": {
      "command": "ltspice-mcp",
      "args": ["--transport", "stdio"],
      "cwd": "/absolute/path/to/ltspice-mcp"
    }
  }
}

按类别划分的核心能力

设置和诊断

• getLtspiceStatus, getLtspiceUiStatus
• daemonDoctor, tailDaemonLog, getRecentErrors, getCaptureHealth

模拟和排队

• simulateNetlist, simulateNetlistFile, runSimulation
• queueSimulationJob, listJobs, jobStatus, cancelJob, listJobHistory

示意图工作流程

• createSchematic, createSchematicFromNetlist, createSchematicFromTemplate
• validateSchematic, lintSchematic, autoDebugSchematic
• inspectSchematicVisualQuality, autoCleanSchematicLayout

数据、测量和验证

• getPlotNames, getVectorsInfo, getVectorData, getLocalExtrema
• getBandwidth, getGainPhaseMargin, getRiseFallTime, getSettlingTime
• parseMeasResults, runMeasAutomation, runVerificationPlan, runSweepStudy

原生LTspice渲染

• renderLtspiceSchematicImage
• renderLtspicePlotImage, renderLtspicePlotPresetImage
• renderLtspiceSymbolImage
• startLtspiceRenderSession, endLtspiceRenderSession

可靠性注意事项

• 流式HTTP默认值已针对兼容性进行了调整：

- json_response = true - stateless_http = true

• 默认情况下禁用UI集成(LTSPICE_MCP_UI_ENABLED=0).
• 默认情况下，启用原理图单窗口更新。
• 渲染使用LTspice+ScreenCaptureKit直接窗口捕获。
• 每次运行都会存储运行工件，以保持历史结果的稳定。

守护进程操作

./scripts/ltspice_mcp_daemon.sh start
./scripts/ltspice_mcp_daemon.sh restart
./scripts/ltspice_mcp_daemon.sh stop
./scripts/ltspice_mcp_daemon.sh status
./scripts/ltspice_mcp_daemon.sh logs --lines 200
./scripts/ltspice_mcp_daemon.sh logs --follow

权限助手：

./scripts/ltspice_mcp_daemon.sh trigger-screen-recording-permission
./scripts/ltspice_mcp_daemon.sh trigger-accessibility-permission

测试

运行核心测试：

PYTHONPATH=src .venv/bin/python -m unittest discover -s tests -v

运行真正的ScreenCaptureKit集成测试（选择加入）：

LTSPICE_MCP_RUN_REAL_SCK=1 PYTHONPATH=src .venv/bin/python -m unittest tests.test_screencapturekit_integration -v
LTSPICE_MCP_RUN_REAL_SCK=1 PYTHONPATH=src .venv/bin/python -m unittest tests.test_plot_render_mcp_real -v

贡献

欢迎捐款。从以下内容开始：

• 贡献.md
• AGENT_README.md 用于特定于代理的工作流

在提交错误时，包括：

• MCP服务器版本，
• LTspice版本，
• 运输方式，
• 精确的工具调用+参数，
• 守护进程日志摘录。

文档地图

• docs/README.md
• AGENT_README.md
• 更改日志.md
• 兼容性.md
• 贡献.md
• 支持.md
• 代码_OF_CONDUCT.md
• 安全.md
• MCP资源： docs://agent-readme
• MCP工具： readAgentGuide

重要环境变量

核心：

• LTSPICE_BINARY
• LTSPICE_MCP_WORKDIR
• LTSPICE_MCP_TIMEOUT
• LTSPICE_MCP_TRANSPORT
• LTSPICE_MCP_HOST
• LTSPICE_MCP_PORT
• LTSPICE_MCP_STREAMABLE_HTTP_PATH
• LTSPICE_MCP_JSON_RESPONSE
• LTSPICE_MCP_STATELESS_HTTP

UI/渲染：

• LTSPICE_MCP_UI_ENABLED
• LTSPICE_MCP_SCHEMATIC_SINGLE_WINDOW
• LTSPICE_MCP_SCHEMATIC_LIVE_PATH
• LTSPICE_MCP_SCK_HELPER_DIR
• LTSPICE_MCP_SCK_HELPER_PATH
• LTSPICE_MCP_VERIFY_WINDOW_CLOSE

登录中：

• LTSPICE_MCP_LOG_LEVEL
• LTSPICE_MCP_TOOL_LOGGING
• LTSPICE_MCP_TOOL_LOG_MAX_ITEMS
• LTSPICE_MCP_TOOL_LOG_MAX_CHARS
• LTSPICE_MCP_DISABLE_UVICORN_NOISE_FILTERS
• LTSPICE_MCP_DAEMON_LOG_DIR