Lazarus MCP

MIT License Live Demo

Lazarus MCP autopsies broken Node/Python repositories, applies conservative resurrection playbooks, reruns install/build/test, and writes judge-ready evidence.

Dead repo in. Working repo out. Evidence included.

Live Lazarus Lab | 60-second judge guide | Evidence report

Why It Exists

Hackathon judges and maintainers need more than an AI claim. They need evidence: what failed, why it failed, what changed, and whether build/test is green afterward. Lazarus keeps the scope narrow and auditable: Node and Python, local paths or public GitHub HTTPS URLs, conservative patches, and no remote pushes.

Quickstart

npm install
npm run build
npm test

Try a local fixture path:

npm run dev -- scan fixtures/dead-node-missing-build
npm run dev -- autopsy fixtures/dead-node-missing-build
npm run dev -- resurrect fixtures/dead-node-missing-build --safe
npm run dev -- evidence-pack fixtures/dead-node-missing-build

Try a GitHub HTTPS URL:

npm run dev -- scan https://github.com/<owner>/<repo>
npm run dev -- autopsy https://github.com/<owner>/<repo>
npm run dev -- resurrect https://github.com/<owner>/<repo> --safe
npm run dev -- evidence-pack https://github.com/<owner>/<repo>

GitHub URLs are cloned into .lazarus-workspaces/<repo-name>-<timestamp>. Lazarus creates local branches only, never pushes upstream, and never modifies remotes.

CLI Usage

lazarus scan <path-or-github-url>
lazarus autopsy <path-or-github-url>
lazarus resurrect <path-or-github-url> [--safe] [--branch <name>]
lazarus evidence-pack <path-or-github-url>

scan detects stack, package manager, config files, scripts, test runner hints, confidence, and health hints. autopsy runs safe install/build/test commands with timeouts and structured log classification. resurrect applies high-confidence playbooks, reruns the pipeline, and never pushes upstream. evidence-pack writes RESURRECTION_REPORT.md, AI_JUDGES.md, and evidence/summary.json.

MCP Tools

The stdio adapter in src/server.ts exposes:

scan_repo
autopsy
resurrect
evidence_pack

The adapter is intentionally thin so the CLI core stays package-agnostic and green if MCP package APIs shift.

Example client configuration after npm run build:

{
  "mcpServers": {
    "lazarus": {
      "command": "node",
      "args": ["/absolute/path/to/lazarus-mcp/dist/server.js"]
    }
  }
}

Proof It Works

tests/detect.test.ts covers stack and pytest detection.
tests/autopsy.test.ts covers log classification and missing-script autopsy.
tests/resurrect.node.test.ts resurrects fixtures/dead-node-esm-cjs and fixtures/dead-node-missing-build.
tests/resurrect.python.test.ts resurrects fixtures/dead-python-missing-pytest.
tests/report.test.ts verifies judge evidence generation.
tests/workspace.test.ts verifies GitHub URL parsing, isolated clone targets, and clone-once behavior.
tests/mcp.test.ts verifies initialization, tool discovery, tool calls, invalid-tool rejection, and a real stdio MCP session.
CI runs clean installs, the CLI/MCP build, all tests, and the production Lazarus Lab build.

Current verified suite: 7 test files / 18 tests.

Demo Flow

Show a broken fixture repository.
Run lazarus autopsy <path> and point to the failing phase and error class.
Run lazarus resurrect <path> --safe.
Show after metrics are green.
Run lazarus evidence-pack <path> and open the generated report files.

Current MVP Scope

Supported stacks: Node and Python.
Supported input: local path or GitHub HTTPS URL.
Supported Node fixes: missing build script, conservative ESM/CJS package type repair, strongly implied TypeScript dependency.
Supported Python fixes: missing pytest dependency when tests/config imply pytest.
Interactive static Lazarus Lab frontend.
No OAuth, remote HTTP MCP server, broad language support, or remote git push.

Safety

Commands time out after 120 seconds by default.
Logs are redacted for obvious secrets.
Lazarus never force-pushes, never pushes, and never modifies remotes.
Low-confidence fixes are reported as suggestions instead of mutations.
Applied changes are intentionally small and auditable.

Product Demo

The Vercel-ready Lazarus Lab lives in apps/web. It is explicitly a static frontend simulation of the working CLI/MCP workflow; arbitrary repositories are not executed on Vercel.

npm run landing:dev
npm run landing:build

Demo script and recording plan:

docs/DEMO_SCRIPT.md
docs/VIDEO_STORYBOARD.md
docs/JUDGE_GUIDE.md

lazarus-mcp