eason4kim-rocket

purify-feeds-mcp

Community eason4kim-rocket
Updated

MCP server for Purify security-intelligence feeds (CISA KEV / EPSS) with per-record provenance

purify-feeds-mcp

MCP server for Purify's production security-intelligence feeds. Lets ClaudeDesktop, Cursor and other MCP clients query live CISA KEV / EPSS / enrichedvulnerability feeds — every answer carries an auditable feed version and fullper-record provenance.

The feeds behind this server are continuously scheduled, quality-gated andself-healing. Each record ships with a _purify data passport: where it wasfetched from, when, with which extractor, and the hash of the raw artifact itcame from.

Tools

Tool Purpose
list_feeds List feeds with record counts and current version (dataset artifact hash)
search_feed AND filters / sort / up to 50 rows, plus an exact total_matched count
get_provenance Return a record's _purify passport and the feed's run chain, by CVE id
check_feed_changed Incremental primitive: compare a known hash to detect new feed versions

Feeds

Name Contents
kev CISA Known Exploited Vulnerabilities catalog
epss EPSS high-risk slice (exploit prediction scores)
enriched EPSS + KEV joined view with risk bands

Install

go install github.com/eason4kim-rocket/purify-feeds-mcp@latest

Or use the Docker image (no Go toolchain needed):

docker pull ghcr.io/eason4kim-rocket/purify-feeds-mcp:latest

Or build from source:

git clone https://github.com/eason4kim-rocket/purify-feeds-mcp
cd purify-feeds-mcp && go build .

Configure (Claude Desktop)

~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "purify-feeds": {
      "command": "/path/to/purify-feeds-mcp",
      "env": {
        "PURIFY_API_URL": "https://feeds.verifly.pro/feeds-api",
        "PURIFY_API_KEY": "<your-api-key>"
      }
    }
  }
}

Or with Docker (the image defaults PURIFY_API_URL to the public gateway):

{
  "mcpServers": {
    "purify-feeds": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "PURIFY_API_KEY",
               "ghcr.io/eason4kim-rocket/purify-feeds-mcp:latest"],
      "env": { "PURIFY_API_KEY": "<your-api-key>" }
    }
  }
}

The public gateway is read-only (GET only, feed whitelist, per-key ratelimits). Health check: https://feeds.verifly.pro/healthz — no key needed.API keys are issued manually during the pilot — open an issue orcontact the maintainer to get one.

Environment variables

  • PURIFY_API_URL — feeds API base URL (default http://127.0.0.1:8091 for local/dev use)
  • PURIFY_API_KEY — API key, sent as a bearer token (required for the public gateway)
  • PURIFY_FEEDS — override the built-in feed table: name=spec_id,...

Example prompts

  • "Which CVEs entered CISA KEV in the last 7 days? Give vendors and remediation due dates."
  • "How many CVEs have EPSS > 0.99 and are in KEV? Top 5?"
  • "Where does the data for CVE-2026-45659 come from?" (get_provenance returns the full passport)
  • Agent loops: remember artifact_hash, call check_feed_changed first on thenext run, and only re-triage when the feed actually changed.

License

MIT

MCP Server · Populars

MCP Server · New