USB Servo Controller MCP server
io.github.Lukasz-Juranek/usb-servo-controller·v0.4.1Drive 12 hobby servos on an open-hardware USB-C controller: moves, poses, sequences, rail current
0 stars185 downloads/wk
Reviews
Write oneNobody has reviewed USB Servo Controller yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
USB Servo Controller tools (16, 2 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
board_statusRail current/voltage, faults, protection limits, and every channel's name, mode, travel limits, speed and current position (0 = off).
clear_faultsClear a latched overcurrent/undervoltage fault so channels can move again.
disable_servosStop driving the given channels (numbers or names); the servos go limp.
go_to_poseMove to a saved pose (see list_poses) and wait until it arrives.
list_posesPoses and the sequence saved from the GUI (servogui.json).
measure_currentSample the servo-rail current continuously; returns peak, mean and min mA.
move_servosMove one or more servos and wait until they arrive.
play_sequencePlay the GUI's saved sequence of poses (move and hold times as saved), repeated `loops` times. Stops early on a fault; capped at 120 s.
read_analogRead channel 0-7 as an analog input (0-4095 counts, 0-3.3 V).
release_portClose the serial port now (servos keep holding) so the GUI or flash.py can use the board. It reopens automatically on the next tool call.
run_scriptwrite actionStart the stored script from the top.
script_statusWhat script is stored on the board, and whether it is running.
set_protectionSet the rail trip limits (0 disables either). Overcurrent is capped at 7500 mA: the board's continuous budget is ~5 A. Resets at power-up.
stop_allPanic stop: every channel off immediately.
stop_scriptStop the stored script; servos keep their positions (stop_all to let go).
upload_scriptwrite actionCompile a servo script and store it in the board's flash, where the firmware runs it without a PC (autorun: also start at every power-up).
Public scan report
scanner v0.1.10 · 2026-10-24 · same rubric, same numbers if you re-run it
- Code scan5 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 1 days ago15/15
- Maintainer identitynamespace and repository owner differ; GitHub account older than a year6/10
How USB Servo Controller compares
Against every graded Productivity MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 89/100
- higher than 80% of 1,299 Productivity servers
- Tools
- 16
- the typical Productivity server has 7
- Tools that change things
- 13%
- typical: 0%. Fewer write tools means less an agent can break
- Downloads a week
- 185
- more than 70% of 427 Productivity servers with a package
What its tools let an agent do: 9 read · 1 create · 3 change · 3 run or deploy
Install USB Servo Controller in Claude Code, Cursor or VS Code
claude mcp add usb-servo-controller -- uvx ucan-servo-mcp
What the publisher says
From the USB Servo Controller repository's README, as published. We do not edit it. Read it on GitHub
USB-C 12-Channel Servo Controller
12-channel USB-C servo controller, Pololu Maestro compatible, with an MCP server so AI agents (Claude, etc.) can drive servos. $18 on Tindie · product page.
▶ 2-minute video: wiring, current monitoring, GUI and the controller driving a real MG995
Open-source alternative to the Pololu Mini Maestro 12 that speaks the Maestro serial protocols, so Maestro libraries work unchanged — plus USB-C, servo-rail current and voltage sensing, on-board scripts. Built for JLCPCB turnkey assembly, ≈ $4.43 per board at 100 units against $29.95 for the Maestro.
AI agents (MCP server)
tools/servo_mcp.py is an MCP server that lets an AI agent move servos, run poses and sequences, and read rail current/voltage, with guardrails: per-channel limits, ramped moves, overcurrent stop. pip install -r tools/requirements.txt, then:
Claude Code
claude mcp add servo -- python /path/to/UsbServoController/tools/servo_mcp.pyClaude Desktop (claudedesktopconfig.json)
{
"mcpServers": {
"servo": {
"command": "python",
"args": ["/path/to/UsbServoController/tools/servo_mcp.py"]
}
}
}Add "--port", "COM5" to pick a port, or "--mock" to try it without hardware. Close the GUI first: only one program can hold the serial port.
The server is also on PyPI, so any MCP client can run it without cloning the repo: command uvx, args ["ucan-servo-mcp"] (plus --config path/to/servogui.json to use the limits, poses and sequences saved by the GUI).
<!-- mcp-name: io.github.Lukasz-Juranek/usb-servo-controller -->
1. Quick start
pip install -r tools/requirements.txt
python tools/servogui.py # GUI (or --mock with no hardware)
python tools/servoctl.py set 0 1500 # CLI
cd embedded-ch32 && make flash # build + flash over USB, ~3 s, no jumperShortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
USB Servo Controller: common questions
- Is USB Servo Controller MCP server safe?
- Yes, by our scan: it is graded A (89/100). Read the USB Servo Controller safety report
- How do I install USB Servo Controller?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does USB Servo Controller need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is USB Servo Controller maintained?
- The last commit was 12 days ago (2026-10-23). The latest release is v0.4.1.
- What can I use instead of USB Servo Controller?
- Servers from other publishers that do the same job: Argent MCP server, gflow-cli MCP server and Buoy Gg MCP server.
- How does USB Servo Controller compare with other Productivity MCP servers?
- safety score 89/100 (higher than 80% of 1,299 Productivity servers); tools 16 (the typical Productivity server has 7); tools that change things 13% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to USB Servo Controller
Same job from other publishers: the closest match first, then the best rated.
- ArgentDrive iOS Simulators, Android emulators, TVs and Electron/web apps from your coding agentnot reviewedWidely usedA
- gflow-cliDrive Google Flow from an agent: Veo video and Imagen image generationnot reviewedEstablishedA
- Buoy GgLet AI agents read and drive a running React Native or Flutter app through Buoy's devtools.not reviewedEstablishedA
- Unreal EngineEngineWire: drive the Unreal Editor (UE 5.0-5.8): levels, Blueprints, UI, materials, VFX and more.not reviewedEstablishedB
- MirroirDrive a stock iPhone via iPhone Mirroring: no Developer Mode, Xcode or WDA. LLM-free skill replay.not reviewedEstablishedC