# 🔒 Security Research MCP

An automated security research aggregator with a **live-streaming web UI** that pulls from IEEE, NIST, CISA, cybersecurity blogs, and policy/legislation sources weekly.

## Features

- **Live Streaming**: New articles appear instantly via Server-Sent Events (SSE)
- **AI Summarization**: OpenAI-powered crisp summaries  
  - Blogs/News → Abstract
  - Papers → Abstract + Methodology + Experiment
- **Flexible Search**: By content, domain, source, date (year / year-month / full date)
- **Multiple Content Types**: Papers, blogs, advisories, news
- **Weekly Auto-Fetch**: Cron-scheduled pulls every Monday

## Sources

| Source | Type | Domain |
|--------|------|--------|
| IEEE Security & Privacy | Papers | Cybersecurity |
| IEEE TIFS | Papers | Cybersecurity |
| NIST CSRC | Papers/Standards | Standards |
| NIST NVD | Advisories | Vulnerabilities |
| CISA Alerts | Advisories | Cybersecurity |
| CISA KEV | Advisories | Vulnerabilities |
| KrebsOnSecurity | Blog | Cybersecurity |
| Schneier on Security | Blog | Cryptography |
| The Hacker News | News | Cybersecurity |
| BleepingComputer | News | Cybersecurity |
| Securelist (Kaspersky) | Blog | Threats |
| Dark Reading | News | Cybersecurity |
| Cisco Talos | Blog | Threats |
| ESET | Blog | Threats |
| ENISA | Policy | Policy |
| Lawfare | Policy | Policy |
| CyberScoop | News | Policy |

## Setup

```bash
cd security-research-mcp
npm install

# Add your OpenAI key to .env (already created)
# Edit .env if needed

# Start the server
npm start

# Or run in dev mode with auto-reload
npm run dev
```

## Usage

1. **Start**: `npm start` → Opens at http://localhost:3000
2. **First fetch**: Click "⚡ Fetch Now" button or run `npm run fetch`
3. **Search**: Use the search panel to filter by keywords, domain, source, date
4. **Click any article**: Expands to show AI-generated summary
   - Papers show: Abstract, Methodology, Experiment
   - Blogs/News show: Crisp Abstract

## API Endpoints

| Endpoint | Method | Description |
|----------|--------|-------------|
| `/api/stream` | GET | SSE live stream of new articles |
| `/api/search?q=&domain=&source=&type=&dateFrom=&dateTo=` | GET | Search with filters |
| `/api/latest?limit=50&offset=0` | GET | Latest articles |
| `/api/article/:id` | GET | Article detail with AI summary |
| `/api/stats` | GET | Database statistics |
| `/api/fetch` | POST | Trigger manual fetch |

## Date Flexibility

The date filter accepts:
- **Year only**: `2025` → searches all of 2025
- **Year-Month**: `2025-07` → searches July 2025
- **Full date**: `2025-07-10` → exact date

## Configuration

Edit `.env`:
```
OPENAI_API_KEY=your-key-here
PORT=3000
FETCH_CRON=0 0 * * 1    # Every Monday at midnight
```

Cron format: `minute hour day-of-month month day-of-week`
- `0 0 * * 1` = Weekly Monday midnight
- `0 */6 * * *` = Every 6 hours
- `0 0 * * *` = Daily midnight