# Shaderous

Shaderous is a Claude Code MCP server that runs gas dynamics and magnetohydrodynamics simulations on the GPU.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 15 repo stars
- Author: guillochon
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/guillochon/shaderous
- Updated: 2026-11-17
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/shaderous

## What it does

Shaderous gives an AI agent tools to load setups, run simulations, read numerical results back, and render outputs. The headless runner requires Node 20 and Chrome with WebGPU support.

The package executes finite-volume computations directly inside a GPU context. Agents can assemble configurations from text descriptions and inspect simulation states through the server tools.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add shaderous -- npx -y shaderous
```

### Codex

**Platform CLI**
```bash
codex mcp add shaderous -- npx -y shaderous
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "shaderous": {
            "command": "npx",
            "args": [
                "-y",
                "shaderous"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "shaderous": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "shaderous"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add shaderous npx -y shaderous
```

## When to use it
- run shock tube simulations via the agent
- read back numerical metrics from a running setup
- generate a gas dynamics configuration from a prompt
- inspect magnetohydrodynamic flows through tool calls

## Example prompts
- Load the Sedov blast setup and run it to the end
- Read the numerical outputs of the current simulation step
- Create a binary star setup with adaptive mesh refinement

## Similar
- [blender-optics-simulator](https://affpapa.org/en/nevibecode/mcp/blender-optics-simulator.md) — MCP server · ★ 38 repo stars
- [comsol-multiphysics-modeler](https://affpapa.org/en/nevibecode/skills/comsol-multiphysics-modeler.md) — skill · 1 install
- [physics-rendering-expert](https://affpapa.org/en/nevibecode/skills/physics-rendering-expert.md) — skill · 201 installs
- [physics-simulation](https://affpapa.org/en/nevibecode/skills/physics-simulation.md) — skill · 187 installs
- [webphysics-avbd-engine](https://affpapa.org/en/nevibecode/skills/webphysics-avbd-engine.md) — skill · 467 installs
- [physics-sim](https://affpapa.org/en/nevibecode/skills/physics-sim.md) — skill · 531 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
