Installation

System dependencies

mcsigrok wraps sigrok-cli, so you need it installed on the host system. The server can start without it (offline mode for browsing decoders), but capture and decode require the binary.

Arch Linux

sudo pacman -S sigrok-cli

Debian / Ubuntu

sudo apt install sigrok-cli

Fedora

sudo dnf install sigrok-cli

macOS (Homebrew)

brew install sigrok-cli

Verify sigrok-cli

sigrok-cli --version

You should see version and driver information. If the command isn’t found, ensure the install location is in your PATH.

Install mcsigrok

pip install mcsigrok

Or with uv:

uv tool install mcsigrok

Add to Claude Code

Register mcsigrok as an MCP server so Claude can access it:

claude mcp add mcsigrok -- uvx mcsigrok

Or if installed via pip:

claude mcp add mcsigrok -- mcsigrok

Verify

Start Claude Code and ask it to scan for devices:

> Scan for connected logic analyzers

If no hardware is connected, Claude will report no devices found — that’s expected. The server is working. You can still browse the decoder catalog and use offline mode without hardware.

USB permissions (Linux)

On Linux, logic analyzers accessed via USB need udev rules so your user can access them without root. Most sigrok-supported devices use the fx2lafw driver (Saleae Logic clones, Cypress FX2-based analyzers).

Create a udev rule:

sudo cp /usr/share/sigrok-cli/udev-rules/*.rules /etc/udev/rules.d/
sudo udevadm control --reload-rules
sudo udevadm trigger

If your distribution doesn’t ship udev rules with sigrok, download them from the sigrok wiki.

Unplug and re-plug your device after adding rules.