# OSV Advisories

> OSV Advisories is an open-source MCP server for security. Look up known vulnerabilities in OSV.dev by package and version, and scan lockfiles. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://basitalisandhu.github.io/dev-mcp-servers/
- **Repository:** https://github.com/basitalisandhu/dev-mcp-servers/tree/HEAD/packages/osv-advisories
- **MCP Registry name:** io.github.basitalisandhu/mcp-osv-advisories
- **Categories:** security, developer tools
- **Listing updated:** 2026-11-15

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

## Tools

- `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.

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

- [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/osv-advisories
