redis-mcp

轻量级 Redis MCP 服务，仅提供两个工具：

• 🧪 redis_run_commands：通过 HTTP/REST 或 TCP 运行一个或多个 Redis 命令，可作为流水线或原子事务执行。
• 📚 redis_search_docs：使用 Context7 公共 API 搜索 Redis 文档。

一个服务可以容纳多个命名数据库。配置仅使用环境变量和 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 的客户端都可以使用。如果列表中没有你的客户端，请添加一个 stdio 服务，并运行 npx -y @upstash/redis-mcp，同时设置上方的两个环境变量。

🧰 工具

🧪 redis_run_commands

运行任意 Redis 命令：GET、SET、SCAN、ZADD、EVAL、SEARCH.* 系列，以及其他所有命令。每条命令都是一个参数数组（接受数字并将其转换为字符串）。默认情况下，多个命令以流水线方式运行：每条命令都会返回各自的结果或错误，并与输入顺序对应；某条命令失败不会中止其余命令。设置 transaction: true 可执行原子性的 MULTI/EXEC。

{
  "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）由目标数据库的配置决定；Agent 不会选择传输方式。

📚 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