redis/mcp-redis

The official Redis MCP Server is a natural language interface designed for agentic applications to manage and search data in Redis efficiently

Redis MCP Server – Redis的自然語言橋樑

是什麼 – 一個輕量級的Python伺服器，讓AI代理能以自然語言（或MCP客戶端支援的任何語言）與Redis對話。它實作了 Model Content Protocol（MCP）傳輸，公開一組「工具」，這些工具直接對應到Redis資料結構（字串、雜湊、列表、集合、有序集合、串流、JSON、發布/訂閱、向量索引等）。

為什麼重要 – 現代LLM驅動的代理需要一種方法，能在不寫低階Redis命令的情況下儲存、取得和搜尋資料。透過將自然語言請求（如 「將對話存入串流」 或 「搜尋這個向量」）轉換為適當的Redis操作，MCP伺服器讓開發者能專注於代理邏輯，而伺服器則負責資料庫互動、認證與擴展。

核心功能

功能	作用
自然語言查詢	代理發送純文字意圖；伺服器將其翻譯為Redis命令。
完整的Redis資料類型支援	字串、雜湊（含嵌入向量）、列表、集合、有序集合、串流、JSON、發布/訂閱、向量索引。
MCP整合	可與任何MCP客戶端（如Claude Desktop、OpenAI Agents SDK）搭配使用。
可擴展且輕量	專為高吞吐、低開銷操作設計；可於Docker容器中執行。
Azure Entra ID認證	原生支援Azure托管Redis的OAuth令牌處理（服務主體、托管身分或預設憑證流程）。
CLI與環境變數設定	所有連接選項（主機、埠、TLS、ACL、叢集模式）皆可透過命令列旗標或環境變數設定。
可擴展工具集	為每種Redis類型提供內建工具，以及用於文件搜尋、向量搜尋管理、伺服器內省的輔助工具。

快速入門

安裝 – pip install redis-mcp-server（或使用Docker鏡像 mcp/redis）。
執行 –
```
uv run redis-mcp-server --url redis://localhost:6379/0
```
（將URI替換為您的Redis實例；使用TLS請使用 rediss://。）
設定客戶端 – 在Claude Desktop、OpenAI Agents SDK等中，新增指向您剛剛啟動命令的MCP伺服器項目。客戶端現在即可發出自然語言命令，伺服器會將其翻譯為Redis操作。

常見使用情境

對話記憶 – 將每次對話存入Redis串流，以便後續檢索或重播。
會話快取 – 使用 string 工具快取LLM回應並設定過期時間。
向量搜尋後端 – 從代理直接建立和查詢向量索引，實現語意搜尋。
即時通知 – 使用 pub/sub 工具發布事件，讓代理訂閱更新。
企業級Azure部署 – 使用Entra ID認證Azure托管Redis，避免使用靜態密碼。

安裝選項

方法	使用方式
PyPI（推薦）	`pip install redis-mcp-server` 後使用 `uv run redis-mcp-server …` 執行
GitHub原始碼	`uvx --from git+https://github.com/redis/mcp-redis.git redis-mcp-server --url redis://…`
Docker	`docker run --rm -e REDIS_HOST=… -e REDIS_PORT=… mcp/redis`
開發用	克隆倉儲，`uv venv && uv sync`，然後 `uv run src/main.py`

設定亮點

CLI旗標 – --url, --host, --port, --ssl, --cluster-mode 等
環境變數 – REDIS_HOST, REDIS_PORT, REDIS_PWD, REDIS_SSL, REDIS_CLUSTER_MODE，以及Entra ID變數（REDIS_ENTRAID_*）
ACL支援 – 可透過標準Redis ACL命令將伺服器限制為唯讀Redis使用者。

生態系統整合

OpenAI Agents SDK – 將伺服器作為OpenAI驅動代理的工具提供者使用。
Claude Desktop – 在Claude的 mcpServers JSON區塊中設定MCP伺服器。
VS Code + GitHub Copilot – 本地執行伺服器，讓Copilot驅動的代理儲存/取得資料。
Augment – （在README中列出）一個更高階的框架，可呼叫MCP伺服器的工具。

取得協助

Discord: https://discord.gg/redis
GitHub Issues / Discussions
Stack Overflow 標籤 mcp-redis
文件 – README本身，以及 https://modelcontextprotocol.io 的MCP規格

授權

MIT – 可自由用於商業與非商業用途。

總結 – Redis MCP Server是一個生產就緒的橋樑，讓LLM驅動的代理能將Redis視為一個可透過自然語言存取的知識儲存庫，全面支援基於Azure的安全認證與Redis的所有原生資料結構。