mcusb

USB device bridge for Model Context Protocol (MCP). Enumerate, inspect, and transfer data with USB devices through structured tools.

Built with FastMCP and PyUSB.

Install

pip install mcusb

# With hot-plug detection (Linux, requires libudev):
pip install mcusb[hotplug]

Or run directly:

uvx mcusb

Register with Claude Code

claude mcp add mcusb -- uvx mcusb

What it does

23 tools for working with USB devices:

• Enumerate — list devices, view topology
• Inspect — descriptors, endpoints, device identification
• Transfer — control, bulk, interrupt, and isochronous read/write
• Manage — kernel drivers, interface claiming, configuration switching
• Monitor — hot-plug event detection via pyudev

4 resources for live device data:

• usb://devices — connected device list
• usb://classes — USB class code reference
• usb://{device_id}/info — full descriptor tree
• usb://events — hot-plug event buffer

All binary data uses hex string encoding. Device IDs use bus:addr format (e.g. 1:2). Write operations require user confirmation via MCP elicitation.

Permissions

USB access typically requires either root privileges or a udev rule. The generate_udev_rule tool creates persistent rules for specific devices:

generate_udev_rule(device_id="1:2")

Environment variables

Requirements

• Python 3.10+
• libusb (system library)
• Linux recommended (udev integration, hot-plug detection)

License

MIT

Links

• warehack.ing
• Repository