🛡️ EUVDB MCP Server

🛡️ EUVDB MCP Server

使用 Python 与 ENISA EUVDB Public Vulnerability API 交互的 MCP 服务，采用 Model Context Protocol (MCP)。

此服务提供可查询的工具，可从 Claude Desktop 或 Visual Studio Code (VSCode) 等兼容 MCP 的 AI 助手中调用。

📁 项目结构

euvdb-mcp-server/
├── Dockerfile # Dockerfile to build the Docker image of the project
├── LICENSE # Project license
├── README.md # Project documentation
├── server.py # MCP server with tools to query the ENISA API
└── pyproject.toml # (optional, if using uv as package manager)

🚀 开始使用

1. 克隆代码库

git clone https://github.com/etxahun/euvdb-mcp-server.git
cd euvdb-mcp-server

2. 创建虚拟环境并安装依赖

要求：Python 3.10 或更高版本，以及 uv 作为环境管理器（可选，但建议使用）。

# Install uv if not already available
curl -LsSf https://astral.sh/uv/install.sh | sh

# Initialize virtual environment
uv venv
source .venv/bin/activate

# Install dependencies
uv add "mcp[cli]" httpx

3. 运行 MCP 服务

• 选项 A：本地运行

  uv run server.py
  

• 选项 B：通过 WSL（Windows Subsystem for Linux）运行

  wsl bash -c 'cd /path/to/euvdb-mcp-server && /home/<user>/.local/bin/uv run server.py'
  

🧪 使用 Docker 本地测试

在终端中运行以下命令：

docker build -t mcp-euvdb .
docker run --rm mcp-euvdb

⚙️ 在 VSCode 中集成 Claude

1. 打开 VSCode，并确保已安装 Claude AI Assistant 扩展。

• 注意：如果你使用的是 “Claude Desktop”，则无需安装该扩展。

2. 打开 settings.json（Ctrl+Shift+P → “Preferences: Open Settings (JSON)”）。

3. 添加以下内容：

"mcp": {
    "servers": {
        "euvdb": {
            "command": "wsl.exe",
            "args": [
                "bash",
                "-c",
                "cd /home/<user>/path/to/project/euvdb-mcp-server && /home/<user>/.local/bin/uv run server.py"
            ]
        }
     }
}

如果已构建 Docker 镜像 mcp-euvdb，可以按以下方式修改 settings.json，将其配置为供 VSCode 直接使用：

"mcp": {
    "servers": {
        "euvdb": {
           "command": "wsl.exe",
           "args": [
               "docker",
               "run",
               "--rm",
               "-i",
               "mcp-euvdb"
           ]
        }
     }
}

🧪 可用工具

MCP 服务提供以下工具：

工具	描述
get_last_vulnerabilities()	最新发布的漏洞（最多 8 个）
get_exploited_vulnerabilities()	最近遭利用的漏洞（最多 8 个）
get_critical_vulnerabilities()	最新的严重漏洞（最多 8 个）
get_vulnerability_by_id(id)	按 CVE ID 查询漏洞（例如：CVE-2024-0864）
get_enisaid(id)	按 ENISA ID 查询（例如：EUVD-2024-45012）
get_advisory(id)	按 ID 获取公告（例如：cisco-sa-ata19x-...）
query_vulnerabilities(...)	使用筛选条件进行高级查询（评分、EPSS、日期、产品等）

💬 提示词示例

• “使用 euvdb 查询最新的严重漏洞。”
• “查询漏洞 CVE-2024-0864。”
• “筛选 2024 年 1 月以来评分 > 9 的漏洞。”
• “显示与 CISCO 相关的近期公告。”

📄 许可证

本项目采用 Apache-2.0 许可。

🤝 致谢

此服务与 ENISA EUVDB Public Vulnerability API 交互。该 API 开放使用，无需身份验证。