# valvur

> valvur is an open-source MCP server for security. Offline security scans for AI-written code: seven open-source scanners, one report. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Linux, macOS, Windows
- **Website:** https://pypi.org/project/valvur/
- **Repository:** https://github.com/maverickhq/valvur
- **MCP Registry name:** io.github.MaverickHQ/valvur
- **Categories:** security, developer tools
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add valvur -- uvx valvur
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "valvur": {
      "command": "uvx",
      "args": [
        "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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/valvur
