nextjs-cache-handler-mcp

Name: nextjs-cache-handler-mcp
Author: leejpsd

本地服务

github.com/leejpsd开发工具69 周前更新

代码仓库

关于 nextjs-cache-handler-mcp

nextjs-cache-handler-mcp 是用于检查和操作 Next.js Redis 缓存的 MCP 服务，面向维护相关部署的开发者和 AI Agent。它可检查标签状态、模拟 SWR 行为，并以确认保护缓存失效操作。

主要功能

01检查 Redis 缓存健康状况
02搜索并解码缓存条目
03查看两层缓存的标签状态
04模拟 SWR 新鲜度与读取行为
05执行软或硬标签失效

适用场景

01诊断页面未更新的原因
02检查缓存条目的 TTL 和标签
03确认失效对缓存层的影响
04在确认后使指定标签失效

MCP 相关

本地 stdio MCP 服务连接用户的 Redis，向 AI Agent 提供缓存检查与操作工具；失效操作默认仅模拟，需确认后执行。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "leejpsd-nextjs-cache-handler": {
      "command": "npx",
      "args": [
        "-y",
        "@leejpsd/nextjs-cache-handler-mcp"
      ],
      "env": {
        "REDIS_URL": "<REDIS_URL>",
        "DEPLOYMENT_VERSION": "<DEPLOYMENT_VERSION>",
        "HASH_TAG": "<HASH_TAG>"
      }
    }
  }
}

启动命令npx -y @leejpsd/nextjs-cache-handler-mcp

需要配置的环境变量

REDIS_URL密钥Redis connection string the cache handler uses

DEPLOYMENT_VERSIONDeploy namespace (recommended)

HASH_TAGSet 'true' when handlers use hashTag: true (Redis Cluster)

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@leejpsd/nextjs-cache-handler-mcp0.1.2stdio

工具

收录的工具列表 · 更新于 2 周前

此工具无需参数。

详细介绍

@leejpsd/nextjs-cache-handler-mcp

用于 @leejpsd/nextjs-cache-handler Redis 缓存的 MCP（Model Context Protocol）服务。让 AI Agent（Claude Code、Cursor、……）能够检查和操作正在运行的部署中的 Next.js 缓存："为什么这个页面没有更新？" 只需调用 tag_state，不必再靠猜测。

设置

项目的 .mcp.json（Claude Code 会自动读取）：

{
  "mcpServers": {
    "nextjs-cache": {
      "command": "npx",
      "args": ["-y", "@leejpsd/nextjs-cache-handler-mcp"],
      "env": {
        "REDIS_URL": "redis://127.0.0.1:6379",
        "DEPLOYMENT_VERSION": "your-deploy-id"
      }
    }
  }
}

在本地通过 stdio 运行，并连接到你自己的 Redis——不会托管任何内容。

AWS/ElastiCache 说明：ElastiCache 位于 VPC 内部，因此在本地运行的 MCP 服务需要 SSH 隧道/堡垒机（将 REDIS_URL 指向该隧道）。在 VPC 内运行的 Agent（CI、集群内）可直接连接。可搭配 AWS Agent 技能/MCP 使用：它们负责基础设施，本服务负责缓存语义。

工具

工具	可解答的问题	写入？
`cache_health`	Redis 是否正常运行？各层/类型缓存了什么？	否
`cache_search`	哪些键与此模式匹配？	否
`cache_inspect`	解码一条缓存项：类型、时长、标签、TTL、压缩情况、大小	否
`tag_state`	此标签当前是否已失效，且是否在两个缓存层中都已失效？	否
`explain_key`	将原始 Redis 键解析为层/类型/命名空间/键	否
`simulate_swr`	此缓存项是新鲜、过时还是已过期？读取时会发生什么？	否
`invalidate_tag`	软失效（SWR）或硬失效——除非设置 `confirm: true`，否则为试运行	受限