ROS 2 Workspace Inspector
About
Statically inspect and diagnose ROS 2 workspaces with AI agents—locally, safely, and without installing ROS.
Details
- Author
- doer0312
- Downloads
- 337
- Categories
- Developer Tools
Jump to
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
ROS 2 Workspace InspectorCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
{
"mcpServers": {
"ros2-workspace-inspector": {
"command": "uv",
"args": [
"--directory",
"/absolute/path/to/ros2-workspace-mcp",
"run",
"ros2-workspace-mcp",
"--root",
"/absolute/path/to/your/ros2_ws"
]
}
}
}
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"ros 2 workspace inspector": {
"ros2-workspace-inspector": {
"command": "uv",
"args": [
"--directory",
"/absolute/path/to/ros2-workspace-mcp",
"run",
"ros2-workspace-mcp",
"--root",
"/absolute/path/to/your/ros2_ws"
]
}
}
}
}McpServers
{
"ros2-workspace-inspector": {
"command": "uv",
"args": [
"--directory",
"/absolute/path/to/ros2-workspace-mcp",
"run",
"ros2-workspace-mcp",
"--root",
"/absolute/path/to/your/ros2_ws"
]
}
}ROS 2 Workspace Inspector is a local-first, read-only MCP server that helps AI agents and robotics developers understand and diagnose ROS 2 workspaces through deterministic static analysis.
It can discover ROS 2 packages, inspect package metadata and build configuration, analyze workspace dependencies, parse custom Msg/Srv/Action interfaces, inspect Python/XML/YAML launch files, examine URDF and Xacro structure, and generate a consolidated workspace diagnosis.
The server does not require ROS, colcon, or a robot runtime to be installed. It does not execute workspace code, setup.py, launch files, Xacro, shell commands, ROS commands, or subprocesses. It never modifies the inspected workspace, and all file access is restricted to the configured workspace root.
The server provides seven analysis tools, one fixed workspace summary resource, one package resource template, and one guided workspace review prompt. It runs locally over MCP stdio and can be used with clients such as Codex, Claude Desktop, Claude Code, Cursor, and other MCP-compatible applications.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
