ROS MCP Server

by lpigeon
MIT License
22

Integrations

  • Supports control of simulated robots in the NVIDIA Isaac Sim environment, demonstrated with the MOCA mobile manipulator

  • Enables robot movement control by sending linear and angular velocity commands to ROS-enabled robots through the rosbridge WebSocket interface

概要

インストール

Smithery経由でインストール

Smithery経由で Claude Desktop 用のros-mcp-server自動的にインストールするには:

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

ローカルにインストールする

uvインストール

  • uvをインストールするには、次のコマンドを使用します。
curl -LsSf https://astral.sh/uv/install.sh | sh

または

pip install uv
  • 仮想環境を作成してアクティブ化する(オプション)
uv venv source .venv/bin/activate

MCP サーバーの構成

MCP 設定を mcp.json に設定します。

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

MCP機能

パブツイスト

  • 目的: 直線速度と角速度を設定してロボットに移動コマンドを送信します。
  • パラメータ:
    • linear : 線速度 (List[Any])
    • angular : 角速度 (リスト[任意])

pub_twist_seq

  • 目的: 一連の移動コマンドをロボットに送信し、複数段階の動作制御を可能にします。
  • パラメータ:
    • linear : 線速度のリスト (List[Any])
    • 角速度のangular (List[Any])
    • duration : 各ステップの継続時間のリスト (List[Any])

使い方

1. rosbridge に接続するための IP とポートを設定します。

  • server.pyを開き、 LOCAL_IPROSBRIDGE_IPROSBRIDGE_PORTを変更します。( ROSBRIDGE_PORTのデフォルト値は9090です)

2. rosbridge サーバーを実行します。

ROS1

roslaunch rosbridge_server rosbridge_websocket.launch

ROS2

ros2 launch rosbridge_server rosbridge_websocket_launch.xml

3. ros-mcp-serverをインポートした AI システムを実行します。

4.「ロボットを前進させる」と入力します。

5. rosbridge_serverros topicを確認します。

  • rosbridge_server
  • ros topic

シミュレーションテスト

NVIDIA Isaac Sim シミュレーション環境内で MOCA モバイル マニピュレータを使用した MCP ベースの制御。

You must be authenticated.

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

ROS と ROS2 の両方と互換性のある自然言語コマンドを通じて直線速度と角速度の正確な操作を可能にする機能を提供することで、ロボットの動作制御を容易にします。

  1. Installation
    1. Installing via Smithery
    2. Installing Locally
    3. uv Installation
    4. MCP Server Configuration
  2. MCP Functions
    1. pub_twist
    2. pub_twist_seq
  3. How To Use
    1. 1. Set IP and Port to connect rosbridge.
    2. 2. Run rosbridge server.
    3. 3. Run any AI system that has imported ros-mcp-server.
    4. 4. Type "Make the robot move forward.".
    5. 5. Check rosbridge_server and ros topic.
  4. Simulation Test
    ID: 8797jpadki