Skip to content
MCP server

npx-vibe

Read-only npm preflight: reviews what install scripts do before packages run

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, macOS, Linux
Runs
Locally
Version
3.0.0
Listing updated
1 day ago

About npx-vibe

npx-vibe is an open-source MCP server for security. It runs locally on your machine and is started by your AI client.

Since npm 12, install scripts are off until you allow them, but npm only shows the command text. npx-vibe downloads the registry tarball, verifies its integrity, parses it in memory and follows install hooks, bin entry points and the relative imports reachable from them. It then reports Proceed, Caution or Block with the file, line number and matched text behind each finding. No install script is executed during review.

Signals include credential reads combined with network calls, downloaded payload execution, suspicious writes and obfuscation, with known advisories from OSV. Registry age, maintainers and download counts are shown as context but never change the score. Review memory is keyed to the verified tarball hash, so a republished version with different bytes reads as changed. Its approve-scripts command classifies packages as approve, review or deny, and --write records exact-version permissions only for clear-cut cases; anything ambiguous is left for a person. It reads package-lock.json directly, so it works on npm 10 and 11 too.

Exit codes (0 proceed, 2 caution, 3 block, 1 error) make it usable in CI and by agents. A Proceed is not a safety guarantee, scope is bounded rather than exhaustive, and the README states that 3.0.0 is the final planned release with active maintenance ended, though it remains available under MIT.

Install

Run in a terminal

claude mcp add npx-vibe -- npx -y npx-vibe

Add to claude_desktop_config.json

{
  "mcpServers": {
    "npx-vibe": {
      "command": "npx",
      "args": [
        "-y",
        "npx-vibe"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "npx-vibe": {
      "command": "npx",
      "args": [
        "-y",
        "npx-vibe"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

What it does

Evidence-backed verdicts
Reports Proceed, Caution or Block with file, line and matched text.
No execution
Parses the tarball in memory and never runs the target's scripts.
Project scans
Reviews a project's locked dependency tree from package-lock.json.
approve-scripts helper
Sorts install scripts into approve, review and deny.
Tarball-hash memory
Remembers decisions by verified hash, so republished bytes read as changed.
CI-friendly exit codes
Distinct codes for proceed, caution, block and error.

Good for

  • Decide which install scripts to allow after upgrading to npm 12
  • Review a new dependency before adding it
  • Gate CI on risky packages in the lockfile
  • Let a coding agent check a package before installing it

Pricing

Open source

Free and open source (MIT)

Prices change. Check devrajsinh-jhala.github.io before you buy.

npx-vibe FAQ

Does it run the package it reviews?

No. Scanning is the default and the archive is parsed in memory; execution needs a separate run command.

Does it need an API key?

No account, AI model or API key is needed for the default scan; Node.js 20 or newer is required.

Is it still maintained?

The README says 3.0.0 is the final planned release and active maintenance has ended.

Does a Proceed guarantee safety?

No. The README says it is not a safety guarantee.

Is npx-vibe free?

Yes. npx-vibe is open source, so you can use and self-host it for free.

How do I add npx-vibe to Claude Code?

Run this command in your terminal: claude mcp add npx-vibe -- npx -y npx-vibe

What are the best alternatives to npx-vibe?

The closest alternatives to npx-vibe are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to npx-vibe

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools