nextjs-cache-handler-mcp — MCP-сервер для Claude Code
MCP-сервер подключает ИИ-агента к Redis-кэшу Next.js: помогает проверить состояние тегов, найти ключи и безопасно выполнить инвалидацию.
claude mcp add --env REDIS_URL=<REDIS_URL> --env DEPLOYMENT_VERSION=<DEPLOYMENT_VERSION> --env HASH_TAG=<HASH_TAG> --transport stdio mcp -- npx -y @leejpsd/nextjs-cache-handler-mcpЧто делает nextjs-cache-handler-mcp
Сервер даёт агенту инструменты для проверки Redis и кэша Next.js. Он показывает состояние кэша по слоям, ищет ключи по шаблону, разбирает отдельную запись, читает теги, TTL, возраст и размеры. tag_state проверяет инвалидацию на обоих слоях, а simulate_swr моделирует поведение записи при чтении.
invalidate_tag поддерживает мягкую и жёсткую инвалидацию и работает в режиме пробного запуска, пока не передать confirm: true. Сервер запускается локально и подключается к Redis через REDIS_URL; эта переменная обязательна. DEPLOYMENT_VERSION задаёт область для инструментов с учётом namespace, а префиксы кэша нужны при нестандартной настройке обработчиков. Для AWS ElastiCache локальному процессу потребуется SSH-туннель или bastion. Без REDIS_URL сервер не подключится к Redis.
Какие задачи решает
- проверить доступность Redis и состав кэша
- найти ключи Next.js по шаблону
- разобрать запись и её TTL
- выяснить состояние тега на двух слоях
- сымитировать чтение свежей или устаревшей записи
Примеры запросов агенту
- Проверь через
cache_health, доступен ли Redis и что сейчас хранится в кэше. - Покажи через
tag_state, инвалидирован ли тегproductsна обоих слоях. - Смоделируй через
simulate_swr, что произойдёт при чтении этой записи.
Как установить nextjs-cache-handler-mcp
Командой платформы
claude mcp add --env REDIS_URL=<REDIS_URL> --env DEPLOYMENT_VERSION=<DEPLOYMENT_VERSION> --env HASH_TAG=<HASH_TAG> --transport stdio mcp -- npx -y @leejpsd/nextjs-cache-handler-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add mcp --env REDIS_URL=<REDIS_URL> --env DEPLOYMENT_VERSION=<DEPLOYMENT_VERSION> --env HASH_TAG=<HASH_TAG> -- npx -y @leejpsd/nextjs-cache-handler-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@leejpsd/nextjs-cache-handler-mcp"
],
"env": {
"REDIS_URL": "<REDIS_URL>",
"DEPLOYMENT_VERSION": "<DEPLOYMENT_VERSION>",
"HASH_TAG": "<HASH_TAG>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@leejpsd/nextjs-cache-handler-mcp"
],
"env": {
"REDIS_URL": "<REDIS_URL>",
"DEPLOYMENT_VERSION": "<DEPLOYMENT_VERSION>",
"HASH_TAG": "<HASH_TAG>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e REDIS_URL=<REDIS_URL> -e DEPLOYMENT_VERSION=<DEPLOYMENT_VERSION> -e HASH_TAG=<HASH_TAG> mcp npx -y @leejpsd/nextjs-cache-handler-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о nextjs-cache-handler-mcp
Как установить nextjs-cache-handler-mcp в Claude Code?
Выполните claude mcp add nextjs-cache-handler-mcp -e REDIS_URL=<REDIS_URL> -- npx -y @leejpsd/nextjs-cache-handler-mcp. Сервер добавится с обязательной переменной REDIS_URL.
Что делает nextjs-cache-handler-mcp?
Он позволяет агенту проверять Redis-кэш Next.js, анализировать ключи и состояние тегов, моделировать SWR и запускать инвалидацию. Операция инвалидации остаётся пробной, пока не задано confirm: true.
Что нужно для работы с AWS ElastiCache?
Если сервер запущен локально, нужен SSH-туннель или bastion до VPC, а REDIS_URL должен указывать на этот туннель. Процесс внутри VPC подключается напрямую.
