ROS 2 Workspace Inspector MCP Server

ROS 2 Workspace Inspector MCP is a local-first, read-only static-analysis MCP server that gives Codex, Claude Code, Cursor, and other MCP clients structured information about ROS 2 workspaces. Seven…

Local serverstdio

What is the ROS 2 Workspace Inspector MCP Server?

ROS 2 Workspace Inspector is an MCP project maintained in the doer0312/ros2-workspace-mcp repository. The maintainer describes its purpose as “ROS 2 Workspace Inspector MCP is a local-first, read-only static-analysis MCP server that gives Codex, Claude Code, Cursor, and other MCP clients structured information about…”. Read the project documentation for the complete scope.

Local setup

The project provides a local client configuration using uv. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
scan_workspaceDiscover ROS 2 packages, workspace layout, build types, and basic manifest metadata.
inspect_packageInspect a package's manifest, build configuration, executables, launch files, interfaces, robot descriptions, and tests.
analyze_dependenciesAnalyze package dependencies, internal dependency edges, topological order, and dependency cycles.
inspect_interfacesParse and inspect ROS 2 Msg, Srv, and Action interface definitions.
analyze_launch_fileStatically analyze a Python, XML, or YAML ROS 2 launch file without executing it.
inspect_robot_descriptionInspect URDF structure and statically summarize Xacro files without expanding or executing them.
diagnose_workspaceRun a consolidated, bounded diagnosis of the configured ROS 2 workspace.

How to install the ROS 2 Workspace Inspector MCP Server

{
  "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"
      ]
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.