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.2.tar.gz (11.7 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.2-py3-none-any.whl (9.3 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: vdb_mcp-0.1.2.tar.gz
  • Upload date:
  • Size: 11.7 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.2.tar.gz
Algorithm Hash digest
SHA256 449e905f8ab85b9c2eb01ae287f597780d17959ca01682cf1581e7431ff7f63b
MD5 9876310338e0ca163d94c962430ba20a
BLAKE2b-256 c698711d25859dee7c50462967ad9c33686b0044a98c24bbcbe76001f7d9dfad

See more details on using hashes here.

File details

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

File metadata

  • Download URL: vdb_mcp-0.1.2-py3-none-any.whl
  • Upload date:
  • Size: 9.3 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.2-py3-none-any.whl
Algorithm Hash digest
SHA256 5dd40b15014acf9e2dcb467ed6a1d680f26a666a225f684ff6da1e8df9d4444c
MD5 7e04b5ddaeef5e54ec2a90ab17785d29
BLAKE2b-256 9dcb5eabb29750690e5c5b2eaca41c1e050ff94044da43707622b1a18261c4c8

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