mcpField
N
nextjs-cache-handler-mcp

nextjs-cache-handler-mcp

ローカル
github.com/leejpsd開発ツール69 週間前に更新
リポジトリ

nextjs-cache-handler-mcp について

nextjs-cache-handler-mcpは、Next.jsのRedisキャッシュを調査・操作するMCPサーバーです。デプロイを扱う開発者やAIエージェント向けに、タグ状態やSWR動作を確認でき、無効化には確認を求めます。

主な機能

  1. 01Redisキャッシュの状態確認
  2. 02キャッシュ項目の検索と解析
  3. 03両キャッシュ層のタグ状態確認
  4. 04SWRの鮮度と読み取りのシミュレーション
  5. 05タグのソフトまたはハード無効化

活用シーン

  1. 01ページが更新されない原因の調査
  2. 02項目のTTLとタグの確認
  3. 03キャッシュ層ごとの無効化影響の確認
  4. 04確認後の指定タグの無効化

MCP 対応

ローカルのstdio MCPサーバーが利用者のRedisに接続し、AIエージェントにキャッシュ調査・操作ツールを提供します。無効化は確認されるまでドライランです。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの 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.2

ツール

7

掲載時のツール一覧 · 2 週間前に更新

このツールにパラメーターはありません。

詳細

@leejpsd/nextjs-cache-handler-mcp

@leejpsd/nextjs-cache-handler の Redis キャッシュ向け MCP（Model Context Protocol）サーバーです。 AI エージェント（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 内で実行するエージェント（CI、クラスター内）は直接接続できます。AWS エージェントスキル／MCP と組み合わせてください。インフラストラクチャはそちらが扱い、このサーバーはキャッシュのセマンティクスを扱います。

ツール

ツール確認できる内容書き込み
cache_healthRedis は稼働していますか？レイヤー／種類ごとに何がキャッシュされていますか？いいえ
cache_searchこのパターンに一致するキーはどれですか？いいえ
cache_inspect1 つのエントリーをデコードします。種類、経過時間、タグ、TTL、圧縮、サイズを確認できますいいえ
tag_stateこのタグは現在、両方のキャッシュレイヤーで無効化されていますか？いいえ
explain_keyRedis の生キーをレイヤー／種類／名前空間／キーに解析しますいいえ
simulate_swrこのエントリーは新鮮／古い／期限切れのどれですか？読み取り時に何が起きますか？いいえ
invalidate_tagソフト（SWR）またはハード無効化 — confirm: true を指定しない限りドライラン条件付き

環境変数：REDIS_URL（必須）、DEPLOYMENT_VERSION（推奨 — 名前空間を認識するツールのスコープを設定）、CACHE_KEY_PREFIX／ISR_KEY_PREFIX（ハンドラーでカスタムプレフィックスを使用している場合のみ）。

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。