nvidia-isaac-mcp
Provides tools to control NVIDIA Isaac Sim and Isaac Lab through natural language, including scene inspection, prim CRUD, physics simulation, robot spawning, and code execution.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@nvidia-isaac-mcpSpawn a Franka robot"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
NVIDIA Isaac MCP
MCP (Model Context Protocol) server for NVIDIA Isaac Sim & Isaac Lab — enables AI tools like Windsurf, Claude Desktop, and Claude Code to control Isaac Sim through natural language.
Architecture
AI Client (Windsurf/Claude) ←— MCP (stdio) —→ nvidia-isaac-mcp (this package)
│
TCP Socket :9876
│
isaacsim.mcp.server
(Extension inside Isaac Sim)Two components:
Isaac Sim Extension (
exts/isaacsim.mcp.server/) — runs inside Isaac Sim, listens on TCP port 9876MCP Server (
src/nvidia_isaac_mcp/) — external Python process that AI tools connect to
Related MCP server: MuJoCo MCP Server
Prerequisites
NVIDIA Isaac Sim 5.x
Python 3.10+
uv (recommended)
Setup
1. Start Isaac Sim with the extension
cd <your-isaac-sim-install>
bash isaac-sim.sh \
--ext-folder <path-to-nvidia-isaac-mcp>/exts \
--enable isaacsim.mcp.serverThe extension will start listening on 127.0.0.1:9876.
2. Run the MCP server
cd <path-to-nvidia-isaac-mcp>
uv run nvidia-isaac-mcp3. Configure your AI tool
Windsurf / Claude Desktop — add to MCP settings:
{
"mcpServers": {
"isaac-sim": {
"command": "uv",
"args": ["run", "--directory", "<path-to-nvidia-isaac-mcp>", "nvidia-isaac-mcp"]
}
}
}Available Tools
Core
Tool | Description |
| Check connectivity to Isaac Sim and return server version |
Scene Inspection
Tool | Description |
| Overview of the current USD stage (prims, up-axis, etc.) |
| Detailed info about a specific prim (attributes, transform, children) |
Prim CRUD
Tool | Description |
| Create a USD prim (Cube, Sphere, Cylinder, Cone, Plane, Capsule, Xform) |
| Modify a prim's transform or visibility |
| Remove a prim from the stage |
Code Execution
Tool | Description |
| Run arbitrary Python code inside Isaac Sim's runtime |
Physics & Simulation
Tool | Description |
| Create a PhysicsScene prim to enable simulation |
| Add rigid body physics to an existing prim |
| Add a physics-enabled ground plane |
| Play, pause, or stop the simulation |
Robots & Assets
Tool | Description |
| Spawn a built-in robot (franka, ur10, jetbot, etc.) |
| List available built-in robot assets |
| Load any USD file as a reference into the stage |
Testing
# Direct TCP test (no MCP server needed, just the extension)
python tests/test_e2e.py
# MCP inspector
uv run mcp dev src/nvidia_isaac_mcp/server.pyEnvironment Variables
Variable | Default | Description |
|
| Extension socket host |
|
| Extension socket port |
This server cannot be deployed
Maintenance
Related MCP Connectors
- alloyOAuthai.usealloy
Connect Claude, Cursor, Codex, and other AI tools to your robotics mission data.
Your AI Agent's Infrastructure Layer. Connect Claude, Copilot, Codex, or ChatGPT to 200+ managed open source services. Start databases, pipelines, and applications through natural language.
Robot embodied-AI cloud for GPU training, inference, benchmarks, and robot data collection.
Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.
Related MCP Servers
- AlicenseAqualityAmaintenanceEnables natural language control of NVIDIA Isaac Sim through the Model Context Protocol, allowing you to create robots, build scenes, run simulations, and debug physics from any MCP-compatible IDE.4239 PyPI64MIT
- AlicenseNot gradedqualityDmaintenanceExposes MuJoCo physics simulation to AI assistants via 65 MCP tools, enabling natural language control of robotics simulation, trajectory optimization, contact analysis, and video export.8MIT
- AlicenseNot gradedqualityDmaintenanceAdvanced robotics simulation platform enabling AI assistants to control complex physics simulations via natural language, built on MuJoCo and MCP.9MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to create, inspect, and animate 3D scenes in Blender through natural language and structured tool calls.6MIT