TraceResolve

Instant SRE incident runbooks & compiler diagnostics for broken stack traces.
Terminal CLI & Model Context Protocol (MCP) server for Cursor, Claude Code, Claude Desktop, and Windsurf.

⚡ Quickstart: Terminal CLI

TraceResolve provides a zero-install terminal hook to diagnose compiler crashes, package conflicts, and runtime panics with zero fluff.

1. Direct Error Diagnosis

npx traceresolve "Error: listen EADDRINUSE: address already in use :::3000"

2. Pipe Failing Commands

# Next.js / Node
pnpm dev 2>&1 | npx traceresolve

# Rust
cargo build 2>&1 | npx traceresolve

# Python
pytest 2>&1 | npx traceresolve

# Docker
docker compose up 2>&1 | npx traceresolve

Output:

✔ Verified Runbook Match (0ms): Node.js: Error: listen EADDRINUSE: address already in use :::3000
─────────────────────────────────────────────────────────────
▶ Immediate Remediation:
lsof -ti :3000 | xargs kill -9

▶ Root Cause: A previous development server, zombie child process, or orphaned background task is still bound to port 3000.
▶ Verification:
  - You can also start your dev server on an alternate port: pnpm dev -p 3001.
─────────────────────────────────────────────────────────────
→ Shareable runbook link: https://traceresolve.com/t/abc1234
→ Web documentation: https://traceresolve.com/errors/port-eaddrinuse-3000

🤖 Model Context Protocol (MCP) Server for AI Agents

Give Cursor, Claude Code, or Windsurf an elite Staff SRE "second set of eyes" to stop AI models from thrashing in compiler error loops.

Cursor Setup

Add to .cursor/mcp.json in your project root or configure in Cursor Settings → Features → MCP:

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

Claude Code CLI Setup

claude mcp add traceresolve-sre -- npx -y traceresolve --mcp

Claude Desktop Setup

Add to your claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

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

🛠️ MCP Tools Exposed

1. resolve_error: Diagnoses any raw stack trace or compiler panic. Client-side sanitizes paths/secrets, checks 0ms canonical SRE runbooks, or queries the live cloud resolution engine. Returns the exact 10-second command fix and verified root cause.
2. search_runbooks: Queries the verified incident catalog by keyword, framework, or error code.
3. get_runbook: Fetches complete verified remediation, root cause, and production caveats by slug.

🔒 Privacy & Zero Egress Sandbox

TraceResolve scrubs proprietary tokens, database connection strings, local Windows/Unix paths, and internal IPs in memory before diagnostic fingerprinting.

🌐 Web Platform

Browse the full catalog of canonical developer runbooks or solve errors via the web UI at:
👉 traceresolve.com

📄 License

MIT © IPFoundry Systems