redis-mcp

Redis 用の軽量な MCP サーバーです。ツールは 2 つだけです。

• 🧪 redis_run_commands：HTTP/REST または TCP 経由で、パイプラインまたはアトミックトランザクションとして、1 つ以上の Redis コマンドを実行します。
• 📚 redis_search_docs：Context7 の公開 API を使用して、Redis のドキュメントを検索します。

1 つのサーバーで、名前付きデータベースを複数保持できます。設定は環境変数と CLI フラグのみで行います。

🔌 クイックスタート

claude mcp add upstash-redis \
  -e UPSTASH_REDIS_REST_URL=https://<your-db>.upstash.io \
  -e UPSTASH_REDIS_REST_TOKEN=<your-rest-token> \
  -- npx -y @upstash/redis-mcp

{
  "mcpServers": {
    "upstash-redis": {
      "command": "npx",
      "args": ["-y", "@upstash/redis-mcp"],
      "env": {
        "UPSTASH_REDIS_REST_URL": "https://<your-db>.upstash.io",
        "UPSTASH_REDIS_REST_TOKEN": "<your-rest-token>"
      }
    }
  }
}

{
  "servers": {
    "upstash-redis": {
      "command": "npx",
      "args": ["-y", "@upstash/redis-mcp"],
      "env": {
        "UPSTASH_REDIS_REST_URL": "https://<your-db>.upstash.io",
        "UPSTASH_REDIS_REST_TOKEN": "<your-rest-token>"
      }
    }
  }
}

[mcp_servers.upstash-redis]
command = "npx"
args = ["-y", "@upstash/redis-mcp"]
env = { UPSTASH_REDIS_REST_URL = "https://<your-db>.upstash.io", UPSTASH_REDIS_REST_TOKEN = "<your-rest-token>" }

{
  "mcp": {
    "upstash-redis": {
      "type": "local",
      "command": ["npx", "-y", "@upstash/redis-mcp"],
      "environment": {
        "UPSTASH_REDIS_REST_URL": "https://<your-db>.upstash.io",
        "UPSTASH_REDIS_REST_TOKEN": "<your-rest-token>"
      }
    }
  }
}

ヒント

MCP 対応クライアントならどれでも使えます。一覧にない場合は、上記の 2 つの環境変数を指定して npx -y @upstash/redis-mcp を実行する stdio サーバーを追加してください。

🧰 ツール

🧪 redis_run_commands

GET、SET、SCAN、ZADD、EVAL、SEARCH.* ファミリーをはじめ、あらゆる Redis コマンドを実行します。各コマンドは引数の配列で指定します（数値も受け付けられ、文字列に変換されます）。デフォルトでは、複数のコマンドはパイプラインとして実行されます。各コマンドの結果またはエラーは入力と同じ順序で返され、1 つの失敗で残りの処理が中断されることはありません。アトミックな MULTI/EXEC を実行するには、transaction: true を設定します。

{
  "commands": [
    ["SET", "visits", 0],
    ["INCR", "visits"],
    ["GET", "visits"],
  ],
  "transaction": false, // optional: true => atomic MULTI/EXEC
  // "database": "prod"       // only when more than one database is configured
  // raw credential overrides (optional):
  // "rest_url", "rest_token" // HTTP
  // "connection_string"      // TCP, rediss://
}

トランスポート（HTTP または TCP）は、対象データベースの設定に基づいて決まります。エージェントが選択することはありません。

📚 redis_search_docs

Upstash Redis のドキュメントをリアルタイムで検索し、関連性の高いページを返します。コマンドや機能が不明な場合、特に SEARCH.* 全文検索ファミリーなど Upstash 固有の機能について確認するときに利用してください。Context7 の無料枠を利用しているため、API キーや追加の設定は必要ありません。

{ "query": "SEARCH.AGGREGATE date histogram" }

⚙️ 設定

環境変数と CLI フラグですべてを設定します。設定ファイルはありません。

単一データベース

複数データベース

各データベースに名前を付けます。この名前は、redis_run_commands で選択できる database の値になります。

環境変数：<NAME> のセグメントを挿入します。

UPSTASH_REDIS_PROD_REST_URL="https://prod-db.upstash.io"
UPSTASH_REDIS_PROD_REST_TOKEN="<prod-rest-token>"
UPSTASH_REDIS_CACHE_TCP_URL="rediss://default:<password>@cache-db.upstash.io:6379"

CLI：データベースごとのグループを開始するために、--database を繰り返し指定します。

npx -y @upstash/redis-mcp \
  --database prod  --rest-url https://prod-db.upstash.io --rest-token <prod-rest-token> \
  --database cache --url rediss://default:<password>@cache-db.upstash.io:6379

メモ

呼び出しごとの生の認証情報。 redis_run_commands の呼び出しでは、rest_url + rest_token（HTTP）または connection_string（TCP）をインラインで指定することもできます。これらはレジストリの設定を上書きし、データベースが設定されていなくても機能します。これらの値はモデルのコンテキストを通じて渡されるため、機密情報には環境変数または CLI を使用してください。

フラグとオプション

📡 テレメトリー

HTTP/REST リクエストには Upstash-Telemetry-{Sdk,Platform,Runtime} ヘッダーが含まれます。--disable-telemetry または UPSTASH_DISABLE_TELEMETRY=true で無効にできます。

🏃 ローカルで実行する

bun install
bun run build                 # emits dist/index.js
cp .env.example .env          # add UPSTASH_REDIS_REST_URL + UPSTASH_REDIS_REST_TOKEN

node dist/index.js                          # stdio (what clients spawn)
node dist/index.js --transport http --port 3000   # HTTP: endpoint /mcp, health /ping

サーバーは .env を自動的に読み込みます。クライアントの接続先をローカルビルドにするには、任意の クイックスタート 設定にある npx -y @upstash/redis-mcp を node /absolute/path/to/redis-mcp/dist/index.js に置き換えてください。

🛠️ 開発

bun install
bun run build
bun test
bun run lint

📄 ライセンス

MIT © Upstash