mcusb 2026.3.6

USB MCP server — enumerate, inspect, and transfer data with USB devices

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

Variable	Default	Purpose
MCUSB_DEFAULT_TIMEOUT	1000	Transfer timeout (ms)
MCUSB_MAX_TRANSFER_SIZE	1048576	Max bytes per transfer
MCUSB_ALLOW_UNGATED_WRITES	(unset)	Allow writes without elicitation
MCUSB_HOTPLUG_BUFFER_SIZE	50	Hot-plug event ring buffer size
MCUSB_WATCH_TIMEOUT	30	Default watch_hotplug timeout (s)

Requirements

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

License

MIT

Links

• warehack.ing
• Repository