CVE Reference MCP Server

CVE ID를 입력받아 CVE 안내서 작성에 필요한 참고자료 목록을 수집·반환하는 MCP 서버입니다.

데이터 원본(NVD, CIRCL, OSV, EPSS, GitHub Advisory) 및 반환 참고자료의 상세 목록은 AGENTS.md § 1. MCP 서버 개요를 참조하세요.

빠른 실행 (npx / pnpm dlx)

별도 설치 없이 GitHub에서 바로 실행할 수 있습니다.

# npx
npx -y github:ch201y00n/cve-mcp

# pnpm
pnpm dlx github:ch201y00n/cve-mcp

Node.js 18 이상이 필요합니다 (global fetch API 사용).

로컬 설치

git clone https://github.com/ch201y00n/cve-mcp.git
cd cve-mcp
npm install

MCP 클라이언트 연동

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) 또는 %APPDATA%\Claude\claude_desktop_config.json (Windows) 에 추가:

{
  "mcpServers": {
    "cve-reference-mcp": {
      "command": "npx",
      "args": ["-y", "github:ch201y00n/cve-mcp"],
      "env": {
        "GITHUB_TOKEN": "ghp_xxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

또는 로컬 설치 후 직접 경로를 지정:

{
  "mcpServers": {
    "cve-reference-mcp": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/cve-mcp/src/index.mjs"],
      "env": {
        "GITHUB_TOKEN": "ghp_xxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Cursor

.cursor/mcp.json 에 추가:

{
  "mcpServers": {
    "cve-reference-mcp": {
      "command": "npx",
      "args": ["-y", "github:ch201y00n/cve-mcp"],
      "env": {
        "GITHUB_TOKEN": "ghp_xxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

GITHUB_TOKEN은 선택 사항이지만 있으면 GitHub Advisory 수집 Rate Limit이 60→5,000/시간으로 증가합니다.

제공 Tool 목록

get_cve_references

CVE 안내서용 참고자료를 전체 수집합니다.

파라미터	타입	기본값	설명
cve_id	string	(필수)	예: CVE-2021-44228
output_format	json | markdown	json	출력 형식
sources	string[]	전체	수집할 원본 선택

get_cve_summary

NVD + EPSS 기반 핵심 정보만 간략 요약합니다.

파라미터	타입	기본값	설명
cve_id	string	(필수)	예: CVE-2021-44228

파라미터 상세 설명, 실제 출력 예시, 테스트 방법은 docs/GUIDE.md 를 참조하세요.