Skip to main content
Glama
deenesjakoruzh

ROS MCP Server

by lpigeon
GitHub
Python
MIT License
124
  • Apple
  • Linux
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Überblick

Statisches AbzeichenStatisches Abzeichen Statisches Abzeichen

Der ROS MCP-Server unterstützt Roboter bei der Ausführung komplexer Aufgaben und der effektiven Anpassung an verschiedene Umgebungen. Er bietet Funktionen, die vom Benutzer über ein LLM eingegebene natürliche Sprachbefehle in ROS-Befehle zur Robotersteuerung umwandeln. Dank rosbridge ist er zudem für den Betrieb mit ROS und ROS2 Systemen konfiguriert. Die WebSocket-basierte Kommunikation ermöglicht eine breite Anwendbarkeit auf verschiedenen Plattformen.

Forschungsergebnisse zu diesem Projekt finden Sie im unten verlinkten Video.

Unterstützte Typen

  • geometry_msgs/Twist
  • sensor_msgs/Bild
  • sensor_msgs/Gelenkzustand

Merkmale

  • Universelle Kompatibilität auf WebSocket-Basis : Kommuniziert über Rosbridge mit ROS- und ROS2-Systemen und ermöglicht so eine nahtlose Integration unabhängig von der ROS-Version.
  • Plattformübergreifende Unterstützung : Funktioniert unter Linux, Windows und MacOS und ist daher für verschiedene Entwicklungs- und Bereitstellungsumgebungen geeignet.
  • Einfache Integration mit LLMs und KI-Systemen : Befehle in natürlicher Sprache können über MCP-Funktionen direkt in Roboteraktionen übersetzt werden.
  • Erweiterbarer Funktionssatz : Fügen Sie durch Erweiterung der MCP-Tool-Schnittstelle ganz einfach neue Robotersteuerungs- oder Sensorfunktionen hinzu.
  • Keine ROS-Knotenänderung erforderlich : Interagiert mit vorhandenen ROS/ROS2-Themen und -Diensten, ohne den Kerncode Ihres Roboters zu ändern.
  • Kompatibilität mit nativen ROS/ROS2-Befehlen : Unterstützt optional die Verwendung lokaler ROS/ROS2-Bibliotheken, sodass Sie native ROS-Befehle und -Tools neben der WebSocket-basierten Steuerung ausführen können.

Beitragen

Beiträge sind willkommen!
Egal, ob Sie einen Tippfehler korrigieren, eine neue Funktion hinzufügen oder Verbesserungen vorschlagen, Ihre Hilfe ist willkommen.
Weitere Einzelheiten zur Mitwirkung an diesem Projekt finden Sie in den Beitragsrichtlinien .

Installation

Installation über Smithery

So installieren Sie ros-mcp-server für Claude Desktop automatisch über Smithery :

npx -y @smithery/cli install @lpigeon/ros-mcp-server --client claude

Lokale Installation

uv -Installation

  • Um uv zu installieren, können Sie den folgenden Befehl verwenden:
curl -LsSf https://astral.sh/uv/install.sh | sh

oder

pip install uv
  • Virtuelle Umgebung erstellen und aktivieren (optional)
uv venv source .venv/bin/activate

MCP-Serverkonfiguration

Setzen Sie die MCP-Einstellung auf mcp.json.

"ros-mcp-server": { "command": "uv", "args": [ "--directory", "/ABSOLUTE/PATH/TO/PARENT/FOLDER/ros-mcp-server",, "run", "server.py" ] }

Wenn Sie Claude Desktop verwenden, können Sie mcp.json mit dem folgenden Befehl finden:

  • MacOS/Linux
code ~/Library/Application\ Support/Claude/claude_desktop_config.json
  • Windows
code $env:AppData\Claude\claude_desktop_config.json

MCP-Funktionen

Die Liste der Funktionen finden Sie in MCPFUNCTIONS.md .

Anwendung

1. Legen Sie IP und Port fest, um eine Verbindung mit Rosbridge herzustellen.

  • Öffnen Sie server.py und ändern Sie Ihre LOCAL_IP , ROSBRIDGE_IP und ROSBRIDGE_PORT . (Der Standardwert von ROSBRIDGE_PORT ist 9090 )

2. Führen Sie den Rosbridge-Server aus.

ROS 1

roslaunch rosbridge_server rosbridge_websocket.launch

ROS 2

ros2 launch rosbridge_server rosbridge_websocket_launch.xml

3. Führen Sie ein beliebiges KI-System aus, das ros-mcp-server importiert hat.

4. Geben Sie „Lass den Roboter vorwärts gehen.“ ein.

5. Überprüfen Sie rosbridge_server und ros topic .

  • rosbridge_server
  • ros topic

Simulationstest

MCP-basierte Steuerung mithilfe des mobilen MOCA-Manipulators innerhalb der NVIDIA Isaac Sim-Simulationsumgebung.

Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

Erleichtert die Steuerung von Roboterbewegungen durch Bereitstellung von Funktionen, die eine präzise Manipulation von linearen und Winkelgeschwindigkeiten durch Befehle in natürlicher Sprache ermöglichen und sowohl mit ROS als auch mit ROS2 kompatibel sind.

  1. Unterstützte Typen
    1. Merkmale
      1. Beitragen
        1. Installation
          1. Installation über Smithery
          2. Lokale Installation
          3. uv -Installation
          4. MCP-Serverkonfiguration
        2. MCP-Funktionen
          1. Anwendung
            1. Legen Sie IP und Port fest, um eine Verbindung mit Rosbridge herzustellen.
            2. Führen Sie den Rosbridge-Server aus.
            3. Führen Sie ein beliebiges KI-System aus, das ros-mcp-server importiert hat.
            4. Geben Sie „Lass den Roboter vorwärts gehen.“ ein.
            5. Überprüfen Sie rosbridge_server und ros topic .
          2. Simulationstest

            Related Resources

            Related MCP Servers

            • CodeSavant

              twolven
              -
              security
              A
              license
              -
              quality
              Provides code manipulation, execution, and version control capabilities. It allows AI assistants to read, write, and execute code while maintaining a history of changes.
              Last updated -
              8
              Python
              MIT License

            • SwitchBot MCP Server

              genm
              A
              security
              A
              license
              A
              quality
              Enables AI assistants to control SwitchBot devices, providing functionalities like device management, scene execution, and sensor information monitoring through the SwitchBot API.
              Last updated -
              3
              JavaScript
              ISC License

            • GS Robot MCP Server

              cfrs2005
              -
              security
              F
              license
              -
              quality
              A Model Control Protocol plugin for controlling GS cleaning robots, supporting robot listing, status monitoring, navigation commands, task execution, and remote control operations.
              Last updated -
              Python
              • Linux
              • Apple

            • ROS2 MCP Server

              kakimochi
              -
              security
              F
              license
              -
              quality
              A Python-based server that enables AI assistants to control robots by integrating the Model Context Protocol (MCP) with ROS 2, allowing for natural language commands that translate into robot movement via the /cmd\_vel topic.
              Last updated -
              55
              Python

            View all related MCP servers

            New MCP Servers

            MCP directory API

            We provide all the information about MCP servers via our MCP API.

            curl -X GET 'https://glama.ai/api/mcp/v1/servers/lpigeon/ros-mcp-server'

            If you have feedback or need assistance with the MCP directory API, please join our Discord server