Skip to content
MCP server

valvur

Offline security scans for AI-written code: seven open-source scanners, one report

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, Linux, macOS
Runs
Locally
Version
1.6.1
Listing updated
3 days ago

About valvur

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

valvur runs Gitleaks, Trivy, OSV-Scanner, Opengrep, Checkov, zizmor and Syft inside one container that has no network interface, then merges their output with its own checks aimed at how AI-generated code goes wrong. Your source is copied in rather than mounted, and each public-data fetch is logged in run.json next to a record that nothing left the machine.

Its own checks look for dependencies that do not exist or sit one edit from a popular name, malicious packages, and agent configuration problems such as injected directives, hidden Unicode, unpinned MCP servers and blanket approvals. Findings are de-duplicated and ranked by CISA KEV and FIRST EPSS exploitation data rather than CVSS alone, with development-only dependencies demoted.

valvur proposes fixes but never applies them, on the reasoning that an agent told to reach zero findings may delete code or add suppressions. Results land in a .security-scan folder in the project.

Install

Run in a terminal

claude mcp add valvur -- uvx valvur

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

{
  "servers": {
    "valvur": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "valvur"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "valvur": {
      "command": "uvx",
      "args": [
        "valvur"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "valvur": {
      "command": "uvx",
      "args": [
        "valvur"
      ]
    }
  }
}

What it does

Seven scanners
Secrets, dependencies, code, infrastructure, CI workflows and SBOM in one pass.
No-network container
Scanners run with no network interface over a copy of your files.
Hallucinated package check
Flags dependency names that do not exist on the major registries.
Agent config checks
Finds injected directives, hidden Unicode and unpinned MCP servers.
Exploitation ranking
Orders findings by KEV and EPSS data, not CVSS alone.
Fixes proposed only
Never edits your code or writes suppressions.

Good for

  • Scan a repo after an AI assistant wrote much of it
  • Catch invented or look-alike package names before install
  • Audit agent settings files for leaked tokens
  • Check GitHub workflows for unpinned actions
  • Produce a CycloneDX SBOM on request

Pricing

Open source

Free to install from PyPI

Prices change. Check pypi.org before you buy.

valvur FAQ

Does my code leave my machine?

The README says no: there is no account, key or telemetry, and run.json records every public-data fetch.

What do I need to run it?

Docker or Podman running, then uvx valvur scan.

Can it install in Claude Code?

Yes, through the plugin marketplace: /plugin marketplace add MaverickHQ/valvur.

Does it fix issues automatically?

No. It proposes fixes and leaves applying them to you.

Is valvur free?

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

How do I add valvur to Claude Code?

Run this command in your terminal: claude mcp add valvur -- uvx valvur

What are the best alternatives to valvur?

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

Alternatives to valvur

  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