Skip to content
plugmcp
DirectorySkillsCategoriesBlog
EN/中文
Sign inSign up
Home/Servers/Gearotons M17 Servomotor

Gearotons M17 Servomotor

by io.github.Gearotons

Drive Gearotons M17 open-source servomotors from plain English over RS-485; mock mode, no hardware.

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Local command
uvx servomotor-mcp==0.3.3
Credentials from the publisher
  • GEAROTONS_MOTOR_BACKEND — 'auto' (default: real serial backend when the servomotor library is installed, otherwise the simulator, which says so in list_serial_ports), 'serial', or 'mock'. For real motors install servomotor-mcp[serial].
  • GEAROTONS_SERIAL_PORT — Optional default port for the connect tool (e.g. /dev/cu.usbserial-210, /dev/ttyUSB0, COM3). Normally unnecessary: the model discovers ports with list_serial_ports.
  • GEAROTONS_DEFAULT_SPEED_DPS — Default speed in degrees/second for the high-level move tools.
Provider
Claude Code
GEAROTONS_MOTOR_BACKEND=<value> GEAROTONS_SERIAL_PORT=<value> GEAROTONS_DEFAULT_SPEED_DPS=<value> claude mcp add io.github.gearotons-servomotor-mcp -- uvx servomotor-mcp==0.3.3

Run in a terminal.

Claude Desktop
{
  "mcpServers": {
    "io.github.gearotons-servomotor-mcp": {
      "command": "uvx",
      "args": [
        "servomotor-mcp==0.3.3"
      ],
      "env": {
        "GEAROTONS_MOTOR_BACKEND": "<value>",
        "GEAROTONS_SERIAL_PORT": "<value>",
        "GEAROTONS_DEFAULT_SPEED_DPS": "<value>"
      }
    }
  }
}

claude_desktop_config.json

Step-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Related MCP

View more
  • Firecrawl🔥 Official Firecrawl MCP Server - Adds powerful web scraping and search to Cursor, Claude and any other LLM clients.
  • N
    NotionToken-auth Notion MCP: pages, databases, blocks, comments, files. Runs headless in CI and agents.
  • Context7Context7 Platform -- Up-to-date code documentation for LLMs and AI code editors

Related skills

View all
  • reaReverse engineer anything with agents, from app behavior down to native binaries.
  • rea-changelog-updatePrepare or rewrite REA release changelogs and GitHub release notes from pinned Git history, with verified contributor thanks and Release Please synchronization.
  • rea-tool-designDesign or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.

Drive Gearotons M17 open-source servomotors from plain English over RS-485; mock mode, no hardware.

servomotor-mcp

Drive open-source Gearotons M17 servomotors from natural language.

An MCP server that exposes the M17 — a NEMA-17 integrated, closed-loop, RS-485 servomotor — to Claude Desktop, Claude Code, or any MCP client. Control real motors by just asking:

"Find my motors and rotate the one on the bench two full turns, slowly."

Nothing is hardcoded: the server discovers your serial ports, auto-detects the motors on the bus (the firmware's "Detect devices" command), and exposes the entire firmware command set — every command in the servomotor library's catalog becomes an MCP tool automatically (48 commands as of library 0.10.0), plus a few high-level tools for everyday moves. It ships with a mock backend, so you can try the whole thing with no hardware.

The first servomotor with an official MCP server. Open hardware, open firmware, open software — and now an open, AI-native control interface.

Quickstart (no hardware, ~2 minutes)

# Run the server directly with uv (recommended). This runs the SIMULATOR —
# for real motors see "Drive real motors" below:
uvx --from servomotor-mcp servomotor-mcp

# or install it:
pip install servomotor-mcp
servomotor-mcp

Then add it to Claude Desktop — copy the block from examples/claude_desktop_config.json into your claude_desktop_config.json, restart Claude Desktop, and ask: "What serial ports do you see? Connect and find my motors." See examples/demo_prompts.md for a scripted demo.

Drive real motors

Plug an M17 (or a daisy-chain of them) into a USB↔RS-485 adapter and install the [serial] extra — that's it, no configuration:

pip install 'servomotor-mcp[serial]'   # pulls in the Gearotons servomotor library
servomotor-mcp

With the servomotor library installed the server uses the real serial backend automatically. Without it, the server runs its simulator and says so: list_serial_ports and connect return a notice field, and a warning goes to stderr. With uv, use uvx --from 'servomotor-mcp[serial]' servomotor-mcp. In a session, the model then:

  1. list_serial_ports — enumerates the machine's ports (macOS /dev/cu.*, Windows COM*, Linux /dev/ttyUSB*), flagging USB serial adapters;
  2. connect — opens the port you (or it) picked, at 230400 baud;
  3. auto-detects every motor on that bus (unique ID + alias) — no address maps to write;
  4. drives them. Tell it in plain English which adapter to use if you have several.

Tools

High-level (discovery + everyday motion):

ToolWhat it does
list_serial_portsEnumerate serial ports with USB metadata (call first).
connect / disconnectOpen a port and auto-detect the motors on that bus.
detect_devicesRe-scan the bus (reboots the motors on it).
list_motorsDetected motors with live position/voltage/temperature/status.
move_to / move_relativeAbsolute / relative moves in degrees; waits for completion.
stopEmergency-stop one or all motors.
get_motor_statusOne motor's snapshot, fatal errors decoded to plain English.
run_sequenceChoreographed steps ("draw a square"), incl. raw command steps.

Plus one tool per firmware command, generated from the library's command catalog: enable_mosfets, go_to_position, move_with_velocity, move_with_acceleration, multimove, homing, zero_position, get_position, get_temperature, set_device_alias, set_pid_constants, system_reset, vibrate, ping, … — anything the motor can do, the model can do. Motors are addressed by their alias number, their 16-hex-digit unique ID, or "all" (broadcast). Values are in friendly units (degrees, seconds, degrees/s, volts, °C); the server converts to firmware units.

How it works

natural language → Claude → MCP tool calls → this server → RS-485 → M17 motors

The server is a thin layer over the Gearotons servomotor Python library. The library is data-driven — motor_commands.json defines every firmware command — and the server turns that same catalog into MCP tools, so new library commands appear automatically. Tool calls are forwarded straight to the hardware — no software clamping; full multi-turn travel, any speed. The motor's own firmware protections (over-current / over-voltage / over-temperature) still apply. The same tools run against the mock backend (GEAROTONS_MOTOR_BACKEND=mock) for development and CI.

Environment variables (all optional):

  • GEAROTONS_MOTOR_BACKEND — auto (default: serial when the servomotor library is installed, else mock), serial, or mock.
  • GEAROTONS_SERIAL_PORT — default port for connect when the model doesn't pass one.
  • GEAROTONS_DEFAULT_SPEED_DPS — default speed for move_to/move_relative (180).

Develop / test

pip install -e '.[dev]'
GEAROTONS_MOTOR_BACKEND=mock pytest     # catalog + mock-bus + server-tool tests

hardware_tests/ contains scripts that exercise the real serial path end to end (port sweep, full command suite, stdio MCP session) against a bench motor.

Status

  • ✅ Full firmware command surface (48 commands), serial-port discovery, bus auto-detection — verified on a physical M17 (fw 0.15.3.0) over a real stdio MCP session and via uvx, on all four test adapters (motor found only where it truly is).
  • ✅ Mock backend + 39 unit tests, no hardware needed.
  • ✅ Cross-platform port handling (macOS / Windows / Linux) via pyserial enumeration.

License

MIT. Hardware, firmware, and software for the M17 are open-source — see github.com/tomrodinger/servomotor.

How do I install Gearotons M17 Servomotor?
Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.
Does Gearotons M17 Servomotor need an API key?
The publisher lists these environment variables: GEAROTONS_MOTOR_BACKEND, GEAROTONS_SERIAL_PORT, GEAROTONS_DEFAULT_SPEED_DPS.
What transport does Gearotons M17 Servomotor use?
Gearotons M17 Servomotor runs locally over stdio.
When was Gearotons M17 Servomotor last checked?
Last checked 2026-10-16. Drive Gearotons M17 open-source servomotors from plain English over RS-485; mock mode, no hardware.

No tool list yet. Remote servers get one after the first health check.

plugmcp

Plug any tool into any agent. MCP servers for people who do not write servers. Gateway for volume, n8n for apps.

  • github.com/TODO
  • x.com/TODO
  • linkedin.com/company/TODO

PlugMCP, 2026

Product
  • Browse
  • Install
  • Host your own
  • Voice mode
  • Browser
Directory
  • All MCP servers
  • Agent skills
  • Categories
  • New
  • Voice
  • Submit a server
Developers
  • Docs
  • Blog
  • What is MCP
  • What is WebMCP
  • Status
Company
  • About
  • Contact
  • Terms
  • Privacy
  • DPA