MCP.so
Sign In

ROS 2 Workspace Inspector

@doer0312

About ROS 2 Workspace Inspector

Statically inspect and diagnose ROS 2 workspaces with AI agents—locally, safely, and without installing ROS.

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

ROS 2 Workspace Inspector gives AI coding agents structured access to the architecture of a local ROS 2 project without running the project itself.

Core capabilities:

  • Discover packages and workspace layout
  • Inspect package manifests, build systems, executables, and project files
  • Analyze internal and external dependencies
  • Parse ROS 2 Msg, Srv, and Action interfaces
  • Statically inspect Python, XML, and YAML launch files
  • Validate URDF structure and summarize Xacro files
  • Generate a consolidated workspace diagnosis
  • Expose compact workspace and package context as MCP Resources
  • Provide a guided ROS 2 workspace review Prompt

Available tools:

  • scan_workspace
  • inspect_package
  • analyze_dependencies
  • inspect_interfaces
  • analyze_launch_file
  • inspect_robot_description
  • diagnose_workspace

Resources:

  • ros2-workspace://summary
  • ros2-workspace://package/{package_name}

Prompt:

  • review_ros2_workspace

Security characteristics:

  • Read-only static analysis
  • Local workspace access only
  • Root-directory sandboxing
  • Path traversal and symlink escape protection
  • No execution of ROS, colcon, shell, setup.py, launch files, or Xacro
  • No modification of workspace files
  • No ROS installation required

Comments

More Developer Tools MCP servers