# CVE Reference MCP Server

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

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

## 빠른 실행 (npx / pnpm dlx)

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

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

# pnpm
pnpm dlx github:ch201y00n/cve-mcp
```

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

## 로컬 설치

```bash
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) 에 추가:

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

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

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

### Cursor

`.cursor/mcp.json` 에 추가:

```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](docs/GUIDE.md)** 를 참조하세요.