Summary
Wraps sigrok-cli as MCP tools so you can control logic analyzers and decode protocol captures directly from Claude. Exposes operations like scanning for devices, capturing samples from hardware, loading session files, and running protocol decoders for I2C, SPI, UART, and more. You get tools for version checks, listing supported drivers and decoders, configuring device parameters, and capturing either by sample count or time duration. Requires sigrok-cli installed locally, which supports a wide range of logic analyzer hardware from Saleae clones to Cypress FX2 based devices. Useful when you're debugging embedded systems and want to analyze signal captures or configure hardware without leaving your conversation.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
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
pip install mcp-sigrok
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
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →