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"] }
}
}
No install at all — point any streamable-HTTP MCP client at the hosted endpoint:
{
"mcpServers": {
"vdb": { "url": "https://vdb.ai.kr/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.
Release files for vdb-mcp 0.2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| vdb_mcp-0.2.0.tar.gz | 42.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| vdb_mcp-0.2.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 83.1 kB
Release files / vdb_mcp-0.2.0.tar.gz
| Download URL | vdb_mcp-0.2.0.tar.gz |
|---|---|
| Size | 42.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
90b509958122477f76ffb3ed729c63e63af57d7a2414a6138f18781d455ffce8
|
|
BLAKE2b-256 checksum How to use checksums |
c5520f1c957f1522211b20b4fb67571d1b49bdc2cfad3ac9edbc0f40c74bb4e8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.3
|
Release files / vdb_mcp-0.2.0-py3-none-any.whl
| Download URL | vdb_mcp-0.2.0-py3-none-any.whl |
|---|---|
| Size | 40.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
19e0e9a74ca8765886a87a5bad11958b7f2d3d9e5709289c56c357fb77b07c76
|
|
BLAKE2b-256 checksum How to use checksums |
a88a6268f38b25094116619f28195a491efc24c9018358f97d9f4d3104b16ce6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.3
|