Skip to main content

MCP server for VDB — AI-aware vulnerability database (packages, MCP servers, models). Check packages for CVEs and slopsquatting before installing.

Project description

vdb-mcp

mcp-name: kr.ai.vdb/vdb

MCP (Model Context Protocol) server for VDB — the AI-aware vulnerability database. Lets Claude Desktop, Claude Code, Cursor, Cline, Continue, and any MCP client check packages while generating code: known CVEs, slopsquatting (LLM-hallucinated package names an attacker may have registered), CISA KEV status, MCP-server trust profiles, and more.

Quick start

uvx vdb-mcp          # or: pipx run vdb-mcp

Claude Desktop (claude_desktop_config.json) / Cursor (.cursor/mcp.json):

{
  "mcpServers": {
    "vdb": { "command": "uvx", "args": ["vdb-mcp"] }
  }
}

That's it — the server talks to the hosted instance at https://vdb.ai.kr by default. Anonymous use gets a free per-IP trial; add an API key for unmetered access (free at https://vdb.ai.kr/signup):

{
  "mcpServers": {
    "vdb": {
      "command": "uvx",
      "args": ["vdb-mcp"],
      "env": { "VDB_API_TOKEN": "vdb_..." }
    }
  }
}

Tools

Tool What it does
vdb_check_package Check one package (purl + optional version) for vulnerabilities, slop risk, KEV
vdb_check_packages Bulk slopsquatting / risk check for a list of packages
vdb_lookup Fetch one advisory by ID (CVE-…, GHSA-…, VDB-SLOP-…)
vdb_search Free-text search over the vulnerability corpus
vdb_check_mcp_server Trust tier + permission scopes of a community MCP server
vdb_list_slopsquatting Current slopsquatting candidates per ecosystem

Environment

Variable Default Meaning
VDB_API_URL https://vdb.ai.kr VDB instance to query (set for self-hosted)
VDB_API_TOKEN (empty) vdb_… API key — unmetered, per-account quota
MCP_MODE stdio stdio or sse (long-running HTTP server)
MCP_PORT 7700 SSE port

Why

LLMs hallucinate package names; attackers register them (slopsquatting). LLMs also happily recommend packages with known RCEs. VDB gives your agent a guardrail: one tool call before npm install / pip install. See https://vdb.ai.kr/connect for the one-line prompt variant that needs no MCP at all.

License

Elastic License 2.0 — free to use, including inside commercial organizations and CI. The only restrictions: you may not offer this software to third parties as a hosted or managed service, or resell it as a product. Commercial licensing beyond that: dev@egdee.com. API usage is governed by the VDB service terms regardless of how you call it.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

vdb_mcp-0.1.1.tar.gz (10.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

vdb_mcp-0.1.1-py3-none-any.whl (8.2 kB view details)

Uploaded Python 3

File details

Details for the file vdb_mcp-0.1.1.tar.gz.

File metadata

  • Download URL: vdb_mcp-0.1.1.tar.gz
  • Upload date:
  • Size: 10.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.3

File hashes

Hashes for vdb_mcp-0.1.1.tar.gz
Algorithm Hash digest
SHA256 5c56bab9a7c390482960a947e5a01ed66cc3fc483ec3e0955608421e0a3710d6
MD5 b25846a5937ca836b563d6af5fcc54d0
BLAKE2b-256 529de5474649d6f4814f1c3c9ae6072656781cc08c1f2e7999e016134f3b3b65

See more details on using hashes here.

File details

Details for the file vdb_mcp-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: vdb_mcp-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 8.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.3

File hashes

Hashes for vdb_mcp-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 bdbfc2a40362068de5d0792a80e51408539ab43d8ea4c56a87983b854163a637
MD5 92d0703bd01163eff0df02e1b93136cd
BLAKE2b-256 783b0cd419c0ff0d0846c92af3983791d80593e22b79b7b75e6d012a7b5a2647

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page