mcp-sigrok

mcp-sigrok — sigrok-cli 的 MCP 服务

将 sigrok-cli 的所有功能作为 MCP 工具提供的 MCP 服务。sigrok-cli 是 sigrok 软件套件的跨平台命令行工具，用于硬件初始化、采集、协议解码和保存逻辑分析仪会话。

安装

pip install mcp-sigrok

要求

• 系统中必须安装 sigrok-cli

安装 sigrok-cli

Debian/Ubuntu：

sudo apt install sigrok-cli

macOS：

brew install sigrok-cli

从源代码安装：

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

用法

作为 MCP 服务

# Run as stdio MCP server
mcp-sigrok

或者在 MCP 设置中配置：

{
  "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 工具

工具	描述
version	获取 sigrok-cli 版本信息
list_supported	列出所有支持的功能
list_hardware_drivers	列出可用的硬件驱动程序
list_input_file_formats	列出支持的输入格式
list_output_file_formats	列出支持的输出格式
list_protocol_decoders	列出可用的协议解码器
scan_for_devices	扫描可检测的设备
show_device_info	显示驱动程序的设备信息
capture	从硬件采集样本
capture_for_time	在指定时长内采集数据
load_file	加载并处理输入文件
show_decoder_docs	显示协议解码器文档
set_config	设置驱动程序配置

示例

从逻辑分析仪采集数据

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

解码 I2C 协议

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

扫描设备

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

开发

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