Skip to main content
Glama
daedalus

mcp-sigrok

by daedalus

mcp-sigrok — MCP server for sigrok-cli

PyPI Python

MCP server that exposes all functionality of sigrok-cli as MCP tools. sigrok-cli is a cross-platform command-line utility for the sigrok software suite, used for hardware initialization, acquisition, protocol decoding, and saving logic analyzer sessions.

Install

pip install mcp-sigrok

Related MCP server: sbl-probe

Requirements

  • sigrok-cli must be installed on the system

Installing sigrok-cli

Debian/Ubuntu:

sudo apt install sigrok-cli

macOS:

brew install sigrok-cli

From source:

git clone git://sigrok.org/sigrok-cli
cd sigrok-cli
./autogen.sh
./configure
make
sudo make install

Usage

As MCP Server

# Run as stdio MCP server
mcp-sigrok

Or configure in your MCP settings:

{
  "mcpServers": {
    "sigrok": {
      "command": "mcp-sigrok"
    }
  }
}

Python API

from mcp_sigrok import (
    check_sigrok_cli,
    get_version,
    list_drivers,
    scan_devices,
    capture_samples,
    load_input_file,
)

# Check if sigrok-cli is available
if cli_path := check_sigrok_cli():
    print(f"Found sigrok-cli at: {cli_path}")

# Get version info
info = get_version()

# List available drivers
drivers = list_drivers()

# Scan for devices
devices = scan_devices()

# Capture samples
result = capture_samples("fx2lafw", samples=1000)

MCP Tools

Tool

Description

version

Get sigrok-cli version info

list_supported

List all supported features

list_hardware_drivers

List available hardware drivers

list_input_file_formats

List supported input formats

list_output_file_formats

List supported output formats

list_protocol_decoders

List available protocol decoders

scan_for_devices

Scan for detectable devices

show_device_info

Show device info for a driver

capture

Capture samples from hardware

capture_for_time

Capture data for duration

load_file

Load and process input file

show_decoder_docs

Show protocol decoder docs

set_config

Set driver configuration

Examples

Capture from logic analyzer

# Capture 1000 samples from fx2lafw device
result = capture(
    driver="fx2lafw",
    samples=1000,
    channels="0-7",
    output_format="hex"
)

Decode I2C protocol

# Load capture file and decode I2C
result = load_file(
    input_file="capture.sr",
    protocol_decoders="i2c",
    output_file="decoded.txt"
)

Scan for devices

# Find available devices
devices = scan_for_devices()
for device in devices.get("devices", []):
    print(f"Found: {device}")

Development

git clone https://github.com/daedalus/mcp-sigrok.git
cd mcp-sigrok
pip install -e ".[test]"

# run tests
pytest

# format
ruff format src/ tests/

# lint
ruff check src/ tests/

# type check
mypy src/

mcp-name: io.github.daedalus/mcp-sigrok

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    F
    maintenance
    MCP server for BusPirate 6 hardware security testing. Exposes UART, SPI, I2C, 1-Wire, power supply, GPIO, and logic analyzer operations as tools.
    2
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    Serial communication and protocol analysis MCP server that gives AI coding assistants direct access to serial ports for reading, writing, decoding, and capturing embedded device output.
    MIT
  • F
    license
    Not graded
    quality
    C
    maintenance
    Local MCP server for building an agent-facing integration around DreamSourceLab DSView. Enables native logic capture, protocol decode, and analysis with artifact management for I2C, SPI, and UART.
    -
  • A
    license
    B
    quality
    B
    maintenance
    MCP server that enables full control of a Flipper Zero device over USB, including screenshots, radio protocols, and app development without requiring a COM port.
    35
    MIT