remote-ros-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| ROS_BRIDGE_HOST | No | Hostname or IP address of the wrosbridge gRPC server. | |
| ROS_BRIDGE_PORT | No | Port of the wrosbridge gRPC server. | |
| REMOTE_ROS_CONFIG_PATH | No | Optional path to a configuration file, overriding the default configuration path. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| ros2_health_checkA | Check the connection and serving health of the remote wrosbridge gateway. |
| ros2_get_nodesA | List all active ROS2 nodes with namespace, pub/sub topics, and services. |
| ros2_get_topicsA | List all available ROS2 topics along with their publisher and subscriber nodes. |
| ros2_get_servicesA | List all active ROS2 services available in the graph. |
| ros2_get_parametersB | Get parameter values for a specific ROS2 node. |
| ros2_set_parametersC | Set runtime parameters for a specific ROS2 node. |
| ros2_lookup_tfA | Lookup geometric coordinate transform between two frames from ROS2 TF tree. |
| ros2_topic_publishB | Publish a message to a ROS2 topic. |
| ros2_topic_echoB | Capture and return messages from a ROS2 topic. |
| ros2_call_serviceA | Call a ROS2 service and receive the response. |
| ros2_action_send_goalA | Send a goal to a ROS2 Action server and optionally wait for result. |
| ros2_action_cancel_goalB | Cancel an executing ROS2 action goal. |
| ros2_assert_topic_publishedA | Assert that a message matching an optional condition has been published to a topic. |
| ros2_measure_topic_hzA | Measure publishing frequency (Hz) and period statistics of a topic. |
| ros2_mock_publish_sequenceB | Publish a sequence of mock messages to stimulate and test subscriber nodes. |
| ros2_record_and_inspectC | Record topic messages for a period and return summary statistics. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| resource_health | Get live health status of wrosbridge gateway. |
| resource_nodes | Get current list of active ROS2 nodes and connections. |
| resource_topics | Get current list of active ROS2 topics. |
TDQS
Scored across 16 tools
Most tools target distinct ROS2 resources and operations—topics, services, actions, parameters, TF, and graph introspection are clearly separated. Minor overlap exists between ros2_topic_publish and ros2_mock_publish_sequence, and between ros2_record_and_inspect and ros2_measure_topic_hz, but descriptions clarify their different intents.
All tool names share a ros2_ prefix and use lowercase snake_case, making them readable and recognizable. However, the internal structure is inconsistent: some are verb-first like ros2_get_nodes and ros2_set_parameters, while others are resource-first like ros2_topic_publish and ros2_action_send_goal, and a few like ros2_record_and_inspect or ros2_health_check break the pattern entirely.
Sixteen tools is slightly above the typical well-scoped range, but each tool covers a distinguishable ROS2 interaction or inspection capability. The extra testing-oriented tools like assert, measure, and mock-publish add value without feeling redundant.
The server covers the major ROS2 interaction surfaces: graph introspection, topics, services, actions, parameters, TF, and health checking. Notable gaps include no way to list message/service/action type definitions and no action goal status listing, but these are workable limitations rather than fatal omissions.