Skip to main content
Glama
Sign In
deenesjakoruzh

ROS MCP Server

by lpigeon
GitHub
Python
MIT License
80
  • 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.

You must be authenticated.

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

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

            • Cursor Talk To Figma MCP

              toiletmadarchut
              A
              security
              F
              license
              A
              quality
              Enables users to control the cursor in Figma through verbal commands using an agentic AI agent, streamlining the design process with a new interaction method.
              Last updated -
              19
              5,185
              1
              JavaScript

            • 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 -
              42
              Python

            • Unitree Go2 MCP Server

              lpigeon
              A
              security
              A
              license
              A
              quality
              A server built on the Model Context Protocol that enables controlling the Unitree Go2 robot using natural language commands, which are translated into ROS2 instructions for the robot to perform corresponding actions.
              Last updated -
              12
              6
              Python
              Apache 2.0
              • Linux

            • pyBittle MCP Server

              cluesang
              -
              security
              F
              license
              -
              quality
              A Python server that enables remote control of Bittle robots via Bluetooth using the Model Context Protocol (MCP), allowing users to programmatically send movement and pose commands.
              Last updated -
              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