Skip to content
MCP server

OSV Advisories

Look up known vulnerabilities in OSV.dev by package and version, and scan lockfiles

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
0.3.0
Listing updated
2 days ago

About OSV Advisories

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

Where many dependency scanners are broad, this one contacts a single host, api.osv.dev over HTTPS, refuses other origins and redirects, and times out at 15 seconds per request. It can check one package, batch up to 1000 packages in chunks of 100, fetch one advisory by ID, or scan a lockfile.

Lockfile parsing covers package-lock.json (v1 to v3), requirements.txt with == pins, poetry.lock, go.sum, Cargo.lock, Gemfile.lock and uv.lock, and lists entries it skipped such as git or path packages. Ecosystem names are normalised, so pypi becomes PyPI, and unknown names return an error rather than an empty result.

An empty result means OSV has no advisory for that exact version, not that the package is safe. It runs over stdio from a pinned Docker image with a read-only mount, reads one file up to 10 MB, sends no telemetry, and is MIT licensed as part of dev-mcp-servers.

Install

Run in a terminal

claude mcp add mcp-osv-advisories -- docker run -i --rm ghcr.io/basitalisandhu/mcp-osv-advisories:0.3.0

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-osv-advisories": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/basitalisandhu/mcp-osv-advisories:0.3.0"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-osv-advisories": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/basitalisandhu/mcp-osv-advisories:0.3.0"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "mcp-osv-advisories": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/basitalisandhu/mcp-osv-advisories:0.3.0"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "mcp-osv-advisories": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/basitalisandhu/mcp-osv-advisories:0.3.0"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "mcp-osv-advisories": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/basitalisandhu/mcp-osv-advisories:0.3.0"
      ]
    }
  }
}

Tools this server provides (4)

Taken from the project documentation; the running server may differ.

query_package
Full advisories for one package by ecosystem, name and optional version.
query_batch
Advisory IDs for up to 1000 packages.
scan_lockfile
Parse a lockfile and batch-query every pinned package.
get_vulnerability
Fetch one advisory in full by ID.

What it does

Package queries
Fetches advisories with CVE aliases, severity and fixed versions.
Batch lookup
Checks up to 1000 packages per call.
Lockfile scanning
Parses seven lockfile formats and reports skipped entries.
Single advisory fetch
Returns one OSV advisory in full by ID.
Restricted network
Only api.osv.dev is contacted; redirects are refused.

Good for

  • Check a dependency version for known CVEs
  • Scan a package-lock.json before a release
  • Look up details for a specific advisory ID
  • Find fixed versions for vulnerable packages

Pricing

Open source

MIT licensed; free

Prices change. Check basitalisandhu.github.io before you buy.

OSV Advisories FAQ

Which hosts does it contact?

Only api.osv.dev over HTTPS.

Does an empty result mean safe?

No. It means OSV has no advisory for that exact package and version.

Which lockfiles are supported?

package-lock.json, requirements.txt, poetry.lock, go.sum, Cargo.lock, Gemfile.lock and uv.lock.

How large can a lockfile be?

Up to 10 MB.

Is OSV Advisories free?

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

How do I add OSV Advisories to Claude Code?

Run this command in your terminal: claude mcp add mcp-osv-advisories -- docker run -i --rm ghcr.io/basitalisandhu/mcp-osv-advisories:0.3.0

What are the best alternatives to OSV Advisories?

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

Alternatives to OSV Advisories

  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