mcp-sigrok — MCP server for sigrok-cli

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
Requirements
- sigrok-cli must be installed on the system
Installing sigrok-cli
Debian/Ubuntu:
sudo apt install sigrok-cli
macOS:
From source:
git clone git://sigrok.org/sigrok-cli
cd sigrok-cli
./autogen.sh
./configure
make
sudo make install
Usage
As MCP Server
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,
)
if cli_path := check_sigrok_cli():
print(f"Found sigrok-cli at: {cli_path}")
info = get_version()
drivers = list_drivers()
devices = scan_devices()
result = capture_samples("fx2lafw", samples=1000)
| 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
result = capture(
driver="fx2lafw",
samples=1000,
channels="0-7",
output_format="hex"
)
Decode I2C protocol
result = load_file(
input_file="capture.sr",
protocol_decoders="i2c",
output_file="decoded.txt"
)
Scan for 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]"
pytest
ruff format src/ tests/
ruff check src/ tests/
mypy src/
mcp-name: io.github.daedalus/mcp-sigrok