pypi vdb-mcpstdioupdated 1mo ago
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.
What can you do with vdb?
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.
Install
Add vdb to your client. Pick the one you use.
claude mcp add vdb-mcp -- uvx vdb-mcpcodex mcp add vdb-mcp -- uvx vdb-mcpamp mcp add vdb-mcp -- uvx vdb-mcp{
"mcpServers": {
"vdb-mcp": {
"command": "uvx",
"args": [
"vdb-mcp"
]
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"vdb-mcp": {
"command": "uvx",
"args": [
"vdb-mcp"
]
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
code --add-mcp '{"name":"vdb-mcp","command":"uvx","args":["vdb-mcp"]}'Or add the block manually to `.vscode/mcp.json` under `servers`.
{
"mcpServers": {
"vdb-mcp": {
"command": "uvx",
"args": [
"vdb-mcp"
]
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
{
"mcpServers": {
"vdb-mcp": {
"command": "uvx",
"args": [
"vdb-mcp"
]
}
}
}Add to `cline_mcp_settings.json` via the MCP Servers panel.
{
"mcpServers": {
"vdb-mcp": {
"command": "uvx",
"args": [
"vdb-mcp"
]
}
}
}Add to `~/.gemini/settings.json`.
{
"mcpServers": {
"vdb-mcp": {
"type": "local",
"command": "uvx",
"args": [
"vdb-mcp"
],
"tools": [
"*"
]
}
}
}Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.
{
"context_servers": {
"vdb-mcp": {
"command": {
"path": "uvx",
"args": [
"vdb-mcp"
]
}
}
}
}Add to your Zed `settings.json`.
uvx vdb-mcpRun `goose configure`, choose **Add Extension → Command-line Extension**, and paste this command.
6 tools
vdb exposes 6 tools to a connected agent.
- 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
Score
65 / 100
Good
- Documentation22/25
- Maintenance16/25
- Trust9/20
- Capability6/15
- Install experience12/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 44 days ago
- Has a release history
- Repository is not archived
- No licence detected
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 6 tool(s) documented
- Provides prompt templates
- Provides resources
- 12 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint — no local install
Version history
| Versions | Published |
|---|---|
| 0.1.2Latest | Jul 19, 2026 |
| 0.1.1 | Jul 19, 2026 |