Logic Analyzer

MIT License Python 3.12+ FastMCP 3.2+

AI-driven USB logic analyzer control via FastMCP 3.2. Capture digital traces with sigrok or the built-in simulator, decode UART/I2C/SPI, and export VCD for PulseView.

How it runs

The MCP server does not bundle sigrok. Install PulseView or sigrok-cli separately, then connect your USB LA.

Hands-in / Hands-out

Fleet pipelines

Quick Start

Set-Location D:\Dev\repos\logic-analyzer-mcp
uv sync --extra dev
just webapp
# Open http://127.0.0.1:10987

STDIO-only (Cursor MCP):

just serve

Dry-run without hardware:

la_device(operation="connect", device_id="sim-la-001")
la_capture(operation="single", sample_rate_hz=1000000, sample_count=4096)
la_decode(operation="uart", rx="D0")

Cursor MCP config

Add to C:\Users\sandr\.cursor\mcp.json:

"logic-analyzer-mcp": {
  "command": "C:/Users/sandr/.local/bin/uv.exe",
  "args": [
    "--directory",
    "D:/Dev/repos/logic-analyzer-mcp",
    "run",
    "python",
    "-m",
    "logic_analyzer_mcp",
    "--stdio"
  ],
  "env": {
    "FASTMCP_BANNER": "0",
    "FASTMCP_UPDATE_CHECK": "0",
    "PYTHONUNBUFFERED": "1",
    "LOGIC_ANALYZER_MCP_BACKEND": "auto"
  }
}

Restart Cursor after editing mcp.json.

Tools

Webapp

just webapp

Documentation

• INSTALL.md — setup paths
• docs/ARCHITECTURE.md — system design
• docs/TOOLS.md — portmanteau reference
• docs/HARDWARE.md — LA buying guide
• docs/BACKENDS.md — sigrok + simulator
• llms.txt — agent discovery index

License

MIT — see LICENSE.