An advanced MCP server that provides structured iterative reasoning for solving complex problems with flexible validation, confidence tracking, revision mechanisms, and branching support.

Installation

NPM

npm install crash-mcp

NPX

npx crash-mcp

Docker

docker build -t crash-mcp .
docker run -i --rm crash-mcp

Bun

bunx -y crash-mcp

Deno

deno run --allow-env=NO_DEPRECATION,TRACE_DEPRECATION,MAX_HISTORY_SIZE,CRASH_STRICT_MODE,CRASH_OUTPUT_FORMAT,CRASH_NO_COLOR --allow-net npm:crash-mcp

Configuration

Cursor

{
  "mcpServers": {
    "crash": {
      "command": "npx",
      "args": ["-y", "crash-mcp"]
    }
  }
}

Claude Desktop

{
  "mcpServers": {
    "crash": {
      "command": "npx",
      "args": ["-y", "crash-mcp"],
      "env": {
        "MAX_HISTORY_SIZE": "100",
        "CRASH_STRICT_MODE": "false",
        "CRASH_OUTPUT_FORMAT": "console",
        "CRASH_NO_COLOR": "false"
      }
    }
  }
}

VS Code

"mcp": {
  "servers": {
    "crash": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "crash-mcp"]
    }
  }
}

Windsurf

{
  "mcpServers": {
    "crash": {
      "command": "npx",
      "args": ["-y", "crash-mcp"],
      "env": {
        "MAX_HISTORY_SIZE": "100",
        "CRASH_STRICT_MODE": "false",
        "CRASH_OUTPUT_FORMAT": "console"
      }
    }
  }
}

Features

Flexible goal types: Extended set including validation, exploration, hypotheses, correction, planning, plus custom goals
Natural language flow: No forced prefixes or rigid formatting (configurable)
Revision mechanism: Correct and improve previous reasoning steps
Branching support: Explore multiple solution paths in parallel
Confidence tracking: Express uncertainty with confidence scores (0-1 scale)
Structured actions: Enhanced tool integration with parameters and expected results
Session management: Multiple concurrent reasoning chains with unique IDs
Multiple output formats: Console, JSON, and Markdown formatting
Strict mode: Compatibility with original rigid validation
Flexible mode: Full access to enhanced features (default)

Environment Variables

Optional

MAX_HISTORY_SIZE - Maximum size of reasoning history
CRASH_STRICT_MODE - Enable strict mode for backward compatibility
CRASH_OUTPUT_FORMAT - Output format (console, JSON, markdown)
CRASH_NO_COLOR - Disable colored output

Usage Examples

use crash to solve complex problems

Use CRASH for systematic analysis when sequential thinking or plan mode falls short

Apply CRASH when an agent can't solve an issue in one shot

Notes

CRASH v2.0 is token-efficient and simplified compared to sequential thinking. It doesn't include code in thoughts and doesn't require agents to enumerate all available tools. Requires Node.js >= v18.0.0. Compatible with Cursor, Claude Code, VSCode, Windsurf, and many other MCP clients.

CRASH MCP Server