Robotics Control MCP-Server

Von MEOK AI Labs | meok.ai

IoT- und Robotik-Schnittstelle für KI-Agenten. Steuern Sie Hardwaregeräte über serielle Schnittstellen und HTTP – Arduino, Raspberry Pi, 3D-Drucker, CNC-Maschinen, Servosteuerungen und kundenspezifische Roboter. Teil des HARVI Humanoid Robotics-Projekts.

Werkzeuge

Werkzeug	Beschreibung
`list_devices`	Automatische Erkennung serieller Schnittstellen + Auflistung registrierter HTTP-Geräte
`send_command`	Senden eines Textbefehls an ein beliebiges Gerät (seriell oder HTTP)
`read_sensor`	Auslesen von Sensorwerten mit automatischer key=value-Analyse
`set_servo`	Einstellen eines Servos auf einen bestimmten Winkel (0-180) auf einem Kanal
`run_gcode`	Senden von G-Code an CNC-Maschinen, 3D-Drucker oder Roboterarme
`emergency_stop`	Software- + Hardware-Not-Aus (blockiert alle Befehle)

Installation

# Core
pip install mcp pyserial

# Optional: for HTTP device communication
pip install httpx

Verwendung

Server starten

python server.py

Claude Desktop-Konfiguration

{
  "mcpServers": {
    "robotics": {
      "command": "python",
      "args": ["/path/to/robotics-control-mcp/server.py"]
    }
  }
}

Beispielaufrufe

Verbundene Geräte erkennen:

Tool: list_devices
Output: {"discovered_serial": [{"port": "/dev/cu.usbmodem1401", "description": "Arduino Mega 2560", "manufacturer": "Arduino"}], "discovered_count": 1}

Befehl an einen Arduino senden:

Tool: send_command
Input: {"device": "/dev/cu.usbmodem1401", "command": "GET_STATUS", "baudrate": 9600}
Output: {"status": "ok", "response": ["STATUS: READY", "TEMP: 23.5", "BATTERY: 87%"]}

Sensor auslesen:

Tool: read_sensor
Input: {"device": "/dev/cu.usbmodem1401", "sensor_id": "temperature"}
Output: {"status": "ok", "response": ["temperature=23.5"], "parsed_values": {"temperature": 23.5}}

Servo steuern:

Tool: set_servo
Input: {"device": "/dev/cu.usbmodem1401", "channel": 0, "angle": 90.0, "speed": 50}
Output: {"status": "ok", "servo": {"channel": 0, "angle": 90.0, "speed": 50}}

G-Code an einen 3D-Drucker senden:

Tool: run_gcode
Input: {"device": "/dev/ttyUSB0", "gcode": "G28\nG1 X50 Y50 Z10 F3000\nG1 X100 Y100 F1500", "baudrate": 115200}
Output: {"total_lines": 3, "successful": 3, "failed": 0}

Befehle an ein HTTP-Gerät senden (ESP32, Raspberry Pi):

Tool: send_command
Input: {"device": "http://192.168.1.100/api/command", "command": "LED_ON"}
Output: {"status": "ok", "response": {"led": "on", "brightness": 255}}

Not-Aus:

Tool: emergency_stop
Input: {"device": "/dev/ttyUSB0"}
Output: {"status": "activated", "emergency_stop": true, "message": "EMERGENCY STOP ACTIVATED. All commands blocked."}

Not-Aus aufheben:

Tool: emergency_stop
Input: {"release": true}
Output: {"status": "released", "emergency_stop": false, "message": "Emergency stop released. Commands enabled."}

Sicherheitsmerkmale

Not-Aus: Softwareseitiger Kill-Switch blockiert ALLE Befehle an ALLE Geräte, wenn er aktiv ist
Hardware-E-Stop: Sendet M112 (seriell) oder ESTOP (HTTP) an das physische Gerät
G-Code-Validierung: Nur gültige G-Code-Zeichen werden akzeptiert
G-Code-Zeilenlimit: Kostenlose Stufe maximal 50 Zeilen pro Aufruf, um unkontrollierte Abläufe zu verhindern
Servo-Begrenzungen: Winkel auf 0-180 Grad validiert, Kanal auf 0-31
Timeouts: Alle seriellen/HTTP-Aufrufe haben konfigurierbare Timeouts
Keine dauerhaften Verbindungen: Jeder Befehl öffnet und schließt seine eigene Verbindung

Unterstützte Geräte

Gerätetyp	Verbindung	Beispiel
Arduino / Teensy	Seriell USB	/dev/cu.usbmodem*, COM3
3D-Drucker (Marlin)	Seriell USB	/dev/ttyUSB0, 115200 Baud
CNC-Maschine (GRBL)	Seriell USB	/dev/ttyUSB0, 115200 Baud
ESP32 / ESP8266	HTTP WiFi	http://192.168.1.x/api
Raspberry Pi	HTTP	http://pi.local:5000/cmd
Servosteuerungen	Seriell	PCA9685, Pololu Maestro
Kundenspezifische Roboter	Seriell/HTTP	Jedes textbasierte Protokoll

HARVI-Integration

Dieser Server ist Teil des HARVI-Projekts für humanoide Robotik von MEOK AI Labs. HARVI verwendet SO-101-Servoarme mit LeRobot ML-Inferenz, die über diesen MCP-Server für KI-gesteuerte Teleoperation und autonome Steuerung verbunden sind.

Preisgestaltung

Stufe	Limit	Preis
Kostenlos	50 Aufrufe/Tag, 50 G-Code-Zeilen/Aufruf	$0
Pro	Unbegrenzt + dauerhafte Verbindungen + Batch-G-Code	$12/Monat
Enterprise	Individuell + Multi-Geräte-Orchestrierung + Sicherheitszertifikate	Kontaktieren Sie uns

Lizenz

MIT

Robotics Control MCP Server