
OSV Advisories
Look up known vulnerabilities in OSV.dev by package and version, and scan lockfiles
- 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.0Add to claude_desktop_config.json
{
"mcpServers": {
"mcp-osv-advisories": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/basitalisandhu/mcp-osv-advisories:0.3.0"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp-osv-advisories": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/basitalisandhu/mcp-osv-advisories:0.3.0"
]
}
}
}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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools