inmoov2-mcp

MCP Server for controlling the InMoov2 3D-printed robot through the MyRobotLab REST API.

Overview

Provides 8 tools for servo and group management, plus optional HTTP+SSE transport with SSL/TLS and CORS support.

Transport	Use Case
inmoov2-mcp	Stdio — for AI assistants (opencode, Claude, Cursor)
inmoov2-mcp-http	HTTP+SSE — for web apps and remote clients

Quick Start

1. Install (the package is not yet published to PyPI):

   pip install git+https://github.com/snfeld/inmoov-mcp.git

2. Start the server:

   # Stdio (for AI assistants)
   inmoov2-mcp
   
   # HTTP+SSE server
   inmoov2-mcp-http --port 8080

Servo Naming

All servos use the format i01.{group}.{servo}:

Example	Full Name
Left arm bicep	i01.leftArm.bicep
Right arm bicep	i01.rightArm.bicep
Left hand index	i01.leftHand.index
Head neck	i01.head.neck

Use the full name (with i01. prefix) when calling individual servo tools. Group tools use only the group name (e.g., leftArm).

Tools

Tool	Description
get_servo_status	Get servo position and movement state
move_servo	Move a single servo to a position
move_group	Move a group with custom positions
move_group_to_position	Move all servos in a group to the same position
set_servo_speed	Set servo movement speed
set_servo_idle_timeout	Set idle power-down timeout
list_servos	List all available servos
list_groups	List all servo groups

Available Servos (20)

Group	Servos
leftArm	bicep, rotate, shoulder, omoplate
rightArm	bicep, rotate, shoulder, omoplate
leftHand	thumb, index, majeure, ringFinger, pinky, wrist
rightHand	thumb, index, majeure, ringFinger, pinky, wrist
head	neck, rothead, rollNeck, eyeX, eyeY, jaw
torso	topStom, midStom, lowStom

Documentation

Language	File
English	Installation Guide
Deutsch	Installationsanleitung
Español	Guía de instalación
Français	Guide d'installation
Italiano	Guida all'installazione
中文	安装指南
日本語	インストールガイド

License

MIT License — see LICENSE.