🛡️ EUVDB MCP Server

🛡️ EUVDB MCP Server

Model Context Protocol (MCP) を使用して、ENISA EUVDB Public Vulnerability API と連携する Python 製の 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 と連携します。