# osv-advisory-mcp-server

osv-advisory-mcp-server queries OSV.dev for known vulnerabilities in packages and dependencies. No API key required.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 432 installs · ★ 2 repo stars
- Author: cyanheads
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/cyanheads/osv-advisory-mcp-server
- Updated: 2026-10-18
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/osv-advisory-mcp-server

## What it does

The server connects to OSV.dev and searches for advisories by package name, version and ecosystem (npm, PyPI, Go, Maven) or Package URL. The `osv_query_batch` tool accepts up to 1000 dependency entries per request and returns a summary: vulnerable count, total CVEs, worst severity. Each advisory includes CVE aliases, fixed version ranges and CWE identifiers.

For Git commit checks, provide a full SHA-1 or SHA-256 hash (40 or 64 hex characters). The server returns vulnerabilities linked to that commit, without tying them to a specific package manager.

Five tools inside: single package query, batch audit, commit lookup, full advisory fetch by ID, and the list of supported ecosystems. HTTP transport install requires no Node.js: the server runs at `https://osv-advisory-mcp-server--cyanheads.run.tools`.

## Requirements
- Remote server: `https://osv-advisory-mcp-server--cyanheads.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http osv-advisory-mcp-server https://osv-advisory-mcp-server--cyanheads.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add osv-advisory-mcp-server --url https://osv-advisory-mcp-server--cyanheads.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "osv-advisory-mcp-server": {
            "url": "https://osv-advisory-mcp-server--cyanheads.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "osv-advisory-mcp-server": {
            "type": "http",
            "url": "https://osv-advisory-mcp-server--cyanheads.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http osv-advisory-mcp-server https://osv-advisory-mcp-server--cyanheads.run.tools
```

## When to use it
- check project dependencies against known CVEs
- find vulnerabilities in a specific library version
- get CVSS scores and fixed version ranges
- audit an SBOM through OSV.dev in one call
- see if a commit is affected by known advisories

## Example prompts
- Check `requests@2.25.1` from PyPI for vulnerabilities
- Run all packages from `package-lock.json` through OSV
- Find vulnerabilities for commit `a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0`

## Similar
- [package-search](https://affpapa.org/en/nevibecode/skills/package-search.md) — skill · ★ 3785 repo stars
- [sbom-cyclonedx-and-cve-reachability-tooling](https://affpapa.org/en/nevibecode/skills/sbom-cyclonedx-and-cve-reachability-tooling.md) — skill · ★ 73 repo stars
- [om-auto-audit-dependencies](https://affpapa.org/en/nevibecode/skills/om-auto-audit-dependencies.md) — skill · 614 installs
- [draft-security-advisory](https://affpapa.org/en/nevibecode/skills/draft-security-advisory.md) — skill · 724 installs
- [Depsonar](https://affpapa.org/en/nevibecode/mcp/depsonar.md) — MCP server
- [Security Intel MCP](https://affpapa.org/en/nevibecode/mcp/security-intel-mcp.md) — MCP server

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
