# @rog0x/mcp-cache-tools

**MCP Server #30** — Caching and memoization tools for AI agents.

Analyze, generate, simulate, and optimize caching strategies across HTTP, CDN, and browser layers.

## Tools

### 1. `analyze_cache_headers`
Analyze HTTP cache headers (Cache-Control, ETag, Last-Modified, Expires, Vary). Grades the overall caching strategy A+ through F and provides actionable improvement suggestions with context-aware advice for static assets, API responses, HTML pages, and media.

### 2. `generate_cache_key`
Generate deterministic cache keys from various inputs:
- **URL mode** — normalizes URL, sorts query params, filters include/exclude params
- **Body mode** — hashes request body with JSON key sorting for consistency
- **Composite mode** — combines multiple key parts into a single deterministic hash

Supports namespacing, versioning, TTL, and outputs ready-to-use Redis/Memcached commands.

### 3. `simulate_cache`
Simulate cache behavior for a sequence of requests. Compare eviction strategies side-by-side:
- **LRU** — Least Recently Used
- **LFU** — Least Frequently Used
- **FIFO** — First In, First Out
- **TTL** — Time-To-Live based expiration

Outputs hit rate, miss rate, eviction count, and step-by-step timeline.

### 4. `check_cdn_headers`
Detect which CDN is serving a resource from response headers. Identifies Cloudflare, Fastly, Akamai, CloudFront, Vercel, Netlify, Google Cloud CDN, Azure CDN, KeyCDN, and Bunny CDN. Reports cache status (HIT/MISS/STALE/BYPASS), edge server, and POP location.

### 5. `analyze_browser_cache`
Analyze what resources a page would cache in the browser. Determines cache type (strong, heuristic, conditional, none), duration, revalidation strategy, and estimates bandwidth/time savings on repeat visits. Groups results by resource type with optimization suggestions.

## Setup

```bash
npm install
npm run build
```

## MCP Configuration

```json
{
  "mcpServers": {
    "mcp-cache-tools": {
      "command": "node",
      "args": ["D:/products/mcp-servers/mcp-cache-tools/dist/index.js"]
    }
  }
}
```

## License

MIT