nikkoxgonzales/crash-mcp

CRASH
Cascaded Reasoning with Adaptive Step Handling
An MCP (Model Context Protocol) server for structured, iterative reasoning. CRASH helps AI assistants break down complex problems into trackable steps with confidence tracking, revision support, and branching for exploring alternatives.
> Inspired by MCP Sequential Thinking Server
---
Why CRASH?
I created this because typing "use sequential_thinking" was cumbersome. Now I can simply say "use crash" instead.
CRASH is more token-efficient than sequential thinking - it doesn't include code in thoughts and has streamlined prompting. It's my go-to solution when an agent can't solve an issue in one shot or when plan mode falls short.
Claude Code's Assessment
---
Features
- **Structured reasoning steps** - Track thought process, outcomes, and next actions
- **Confidence tracking** - Express uncertainty with 0-1 scores, get warnings on low confidence
- **Revision mechanism** - Correct previous steps, with original steps marked as revised
- **Branching support** - Explore multiple solution paths with depth limits
- **Dependency validation** - Declare and validate step dependencies
- **Session management** - Group related reasoning chains with automatic timeout cleanup
- **Multiple output formats** - Console (colored), JSON, or Markdown
- **Flexible validation** - Strict mode for rigid rules, flexible mode for natural language
---
Installation
Or use directly with npx:
Quick Setup
Most MCP clients use this JSON configuration:
Configuration by Client
| Client | Setup Method |
|--------|-------------|
| **Claude Code** | claude mcp add crash -- npx -y crash-mcp |
| **Cursor** | Add to ~/.cursor/mcp.json |
| **VS Code** | Add to settings JSON under mcp.servers |
| **Claude Desktop** | Add to claude_desktop_config.json |
| **Windsurf** | Add to MCP config file |
| **JetBrains** | Settings > Tools > AI Assistant > MCP |
| **Others** | Use standard MCP JSON config above |
Windows Users
Use the cmd wrapper:
With Environment Variables
Using Docker
Alternative Runtimes
**Bun:**
**Deno:**
---
Configuration
| Variable | Default | Description |
|----------|---------|-------------|
| CRASH_STRICT_MODE | false | Enable strict validation (requires specific prefixes) |
| MAX_HISTORY_SIZE | 100 | Maximum steps to retain in history |
| CRASH_OUTPUT_FORMAT | console | Output format: console, json, markdown |
| CRASH_NO_COLOR | false | Disable colored console output |
| CRASH_SESSION_TIMEOUT | 60 | Session timeout in minutes |
| CRASH_MAX_BRANCH_DEPTH | 5 | Maximum branch nesting depth |
| CRASH_ENABLE_SESSIONS | false | Enable session management |
---
Usage
Required Parameters
| Parameter | Type | Description |
|-----------|------|-------------|
| step_number | integer | Sequential step number (starts at 1) |
| estimated_total | integer | Estimated total steps (adjustable) |
| purpose | string | Step category: analysis, action, validation, exploration, hypothesis, correction, planning, or custom |
| context | string | What's already known to avoid redundancy |