Vulners MCP

🚀 Vulners MCP 服務器

Vulners MCP 是一個模型上下文協議（MCP）服務器，它通過像 Claude Desktop 這樣的 AI 助手，為用戶提供對 Vulners 漏洞數據庫的無縫訪問。安全研究人員和開發人員可以直接通過自然語言對話，查詢全面的漏洞數據、搜索 CVE 編號、分析安全公告以及審核軟件包。

🚀 快速開始

與 Claude Desktop 快速上手

使用 Vulners MCP 最簡單的方法是通過 Claude Desktop：

1. 構建 Docker 鏡像

git clone https://github.com/vulnersCom/vulners-mcp.git
cd vulners-mcp
docker build -t vulners-mcp:latest .

2. 配置 Claude Desktop

將以下內容添加到你的 Claude Desktop 配置文件中：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json
• Linux：~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "vulners": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "VULNERS_API_KEY=YOUR_API_KEY_HERE",
        "vulners-mcp:latest"
      ]
    }
  }
}

將 YOUR_API_KEY_HERE 替換為你實際的 Vulners API 密鑰。

3. 重啟 Claude Desktop

保存配置後，重啟 Claude Desktop。Vulners MCP 服務器將通過 🔌 圖標可用。

4. 開始使用

現在你可以向 Claude 提出如下問題：

• "查找 Google Chrome 最近的漏洞"
• "顯示 CVE - 2025 - 53770 的詳細信息"
• "Citrix 產品最近有哪些被利用的漏洞"
• "審核此軟件：cpe:2.3:a:google:chrome:138.0.7204.184:::::::*"
• "審核 Ubuntu 22.04 軟件包 'openssl 3.0.2 amd64' 和 'curl 7.81.0 - 1ubuntu1.14 amd64'"

✨ 主要特性

• AI 助手集成：與 Claude Desktop 和其他 MCP 兼容的客戶端原生協作。
• 雙傳輸支持：自動檢測並支持標準輸入輸出（適用於 Claude Desktop）和 HTTP 傳輸。
• 全面的工具集：提供 7 種用於漏洞研究的 MCP 工具，包括：
  • 對超過 400 萬個漏洞公告進行全文 Lucene 搜索。
  • 獲取 CVE 和公告信息。
  • 軟件/軟件包漏洞審核。
  • CPE 搜索和自動補全。
  • Linux 軟件包漏洞審核。
• 靈活的部署方式：支持 Docker、本地構建或通過 PyPI 安裝。
• 基於環境的配置：通過環境變量進行簡單的設置。

📦 安裝指南

使用運行腳本的 Docker 方式

若要輕鬆部署 HTTP 模式，可使用提供的運行腳本：

# 創建包含 API 密鑰的 .env 文件
echo "VULNERS_API_KEY=your_api_key_here" > .env

# 運行服務器
./run-docker.sh

服務器將以 HTTP 模式在 http://0.0.0.0:8000/mcp 啟動。

手動 Docker 方式

以 HTTP 模式運行 MCP 服務器：

docker run -d \
  --name vulners-mcp-http \
  -e MCP_TRANSPORT_MODE="http" \
  -e VULNERS_BASE_URL="https://vulners.com" \
  -e VULNERS_API_KEY="your_api_key" \
  -p 8000:8000 \
  vulners-mcp:latest

對於 Claude Desktop（標準輸入輸出模式），請使用 -i 標誌：

docker run -i --rm \
  -e VULNERS_API_KEY="your_api_key" \
  vulners-mcp:latest

本地構建並運行

git clone https://github.com/vulnersCom/vulners-mcp.git
cd vulners-mcp
poetry install 
export VULNERS_API_KEY="your_api_key"
poetry run python -m vulners_mcp

📚 詳細文檔

配置 / 環境變量

傳輸模式說明：

• 服務器會根據運行方式自動檢測傳輸模式。
• 使用 MCP_TRANSPORT_MODE=http 可明確強制使用 HTTP 模式（適用於獨立的 HTTP 服務器）。
• Claude Desktop 在使用 docker run -i 運行時會自動使用標準輸入輸出模式。

使用方法和端點

使用 Claude Desktop

只需用自然語言提問，例如：

• "搜索 Apache 的漏洞"
• "獲取 CVE - 2024 - 1234 的信息"
• "審核軟件 cpe:/a:vendor:product:version"

HTTP 模式

以 HTTP 模式運行時，客戶端連接到：

http://<FASTMCP_HOST>:<FASTMCP_PORT>/mcp

默認地址：http://0.0.0.0:8000/mcp

測試

使用提供的測試腳本來測試 HTTP 服務器：

# 確保 HTTP 服務器正在運行
docker ps | grep vulners-mcp

# 運行測試腳本
python3 test_tools.py

測試腳本將執行以下操作：

1. 檢查服務器健康狀況。
2. 初始化 MCP 協議。
3. 列出可用工具。
4. 測試 CVE 搜索功能。
5. 測試 Lucene 搜索。

可用工具

服務器提供 7 種用於漏洞研究的 MCP 工具：

搜索與發現

• search_lucene - 🔍 未知漏洞發現工具 🔍 使用 Lucene 語法在 Vulners 知識庫中進行全文搜索。僅在沒有特定 ID 或版本信息時使用。切勿用於已知的 CVE/公告 ID（請使用 bulletin_by_id），也不要用於特定軟件版本（例如 'Chrome 138.0.7204.184'，請使用 audit_software）。🚨 重要提示：對於供應商/產品搜索，始終使用 cnaAffected.vendor 和 cnaAffected.product 字段，因為 affectedSoftware 字段不存在。
• bulletin_by_id - 🚨 已知 ID 的主要工具 🚨 通過 CVE 或 Vulners ID 獲取完整公告。當你有特定標識符（如 CVE - 2024 - 1234、RHSA - 2024:001、CTX694938 等）時使用。支持單個 ID 或 ID 列表。提供列表時，引用將自動設為 False。切勿對已知 ID 使用 search_lucene。
• query_autocomplete - 搜索輸入（供應商、產品、CVE 等）的自動補全助手。從 Vulners 數據庫獲取搜索建議。
• search_cpe - 按供應商 + 產品查找 CPE 字符串（最新架構）。在 Vulners 數據庫中搜索通用平臺枚舉標識符。

漏洞審核

• audit_software - 🔍 特定版本軟件審核 🔍 審核特定軟件版本的已知漏洞。當你有確切的軟件版本信息（例如 Chrome 138.0.7204.184）時使用。切勿對特定版本軟件審核使用 search_lucene。
• audit_linux_packages - 針對給定發行版 + 版本的 Linux 軟件包審核（RPM/DEB）。根據 Vulners 數據庫分析 Linux 軟件包漏洞。

信息與系統支持

• get_supported_os - 列出 Linux 軟件包審核支持的操作系統標識符/版本。獲取可用於漏洞分析的操作系統列表。

工具選擇指南

🚨 關鍵工具選擇規則 🚨

何時使用每個工具

• bulletin_by_id：當你有特定 ID 時使用
  • ✅ "分析 CVE - 2025 - 7775" → bulletin_by_id
  • ✅ "查找 CTX694938" → bulletin_by_id
  • ✅ "告訴我 CVE - 2021 - 44228 的信息" → bulletin_by_id
  • ✅ 任何特定的 CVE、RHSA、MS、CTX、NCSC、THN 等 ID
• search_lucene：僅在沒有特定 ID 時用於發現
  • ✅ "查找 Apache 中的漏洞" → search_lucene
  • ✅ "顯示最近的 CVE" → search_lucene
  • ✅ "Chrome 存在哪些漏洞？" → search_lucene
  • ❌ 切勿對已知 ID 使用，應使用 bulletin_by_id
• audit_software：用於特定版本軟件審核
  • ✅ "審核 Chrome 138.0.7204.184" → audit_software
  • ✅ "檢查 Firefox 120.0 中的漏洞" → audit_software
  • ✅ 當你有供應商 + 產品 + 版本信息時使用
  • ❌ 不要僅用於供應商 + 產品（應使用 search_lucene）

效率規則：對於已知 ID，一次 bulletin_by_id 調用就足夠了。除非明確要求擴大範圍，否則不要接著使用 search_lucene。

審核工具的後續工作流程

當使用審核工具（audit_software、audit_linux_packages）時：

• ✅ 運行審核工具以識別易受攻擊的軟件並獲取 CVE ID。
• ✅ 從響應的漏洞數組中提取 CVE ID。
• ✅ 使用 bulletin_by_id 和 CVE ID 列表進行詳細分析。
• ✅ 這將提供全面的漏洞信息，包括補丁、引用和利用數據。
• ✅ 使用 bulletin_by_id 進行批量處理比多次單獨調用更高效。

如需詳細的工具文檔和參數，請使用 Claude 的工具檢查功能或查看服務器的工具列表。

開發與貢獻

• 在 GitHub 上提出問題或功能請求。
• 提交改進的拉取請求。
• 確保與 Vulners API 兼容。
• 測試標準輸入輸出（Claude Desktop）和 HTTP 模式。

從源代碼構建

git clone https://github.com/vulnersCom/vulners-mcp.git
cd vulners-mcp
docker build -t vulners-mcp:latest .

📄 許可證

本項目採用 MIT 許可證。

MCP 名稱：io.github.vulnersCom/vulners-mcp