Redis MCP 伺服器 - 項目詳細介紹

項目概述

Redis MCP 伺服器是 Redis 官方開發的模型內容協定 (Model Content Protocol) 伺服器，為 AI 代理應用提供自然語言介面，使其能夠高效地管理和搜尋 Redis 中的資料。該項目與 MCP 客戶端無縫整合，支援 AI 驅動的工作流程與 Redis 中的結構化和非結構化資料進行互動。

項目地址: https://github.com/redis/mcp-redis

核心特性

🤖 自然語言查詢

• 支援 AI 代理使用自然語言查詢和更新 Redis 資料
• 可以處理諸如 "將整個對話儲存在流中"、"快取此項目"、"儲存帶有過期時間的會話" 等自然語言指令

🔗 無縫 MCP 整合

• 與任何 MCP 客戶端相容，實現流暢的通訊
• 支援 stdio 和 SSE 兩種傳輸協定

📊 全面的 Redis 支援

支援 Redis 的所有主要資料結構：

• 字串 (String): 儲存簡單配置值、會話資料或快取回應
• 雜湊 (Hash): 儲存欄位-值對，支援向量嵌入儲存
• 列表 (List): 佇列、訊息代理或維護最近操作列表
• 集合 (Set): 追蹤唯一值，支援集合運算
• 有序集合 (Sorted Set): 排行榜、優先佇列、基於時間的分析
• 發布/訂閱 (Pub/Sub): 實時通知、聊天應用、分發更新
• 流 (Streams): 事件溯源、活動源、感測器資料記錄
• JSON: 複雜嵌套資料結構、文檔資料庫

🔍 搜尋與過濾

• 支援高效的資料檢索和搜尋
• 向量索引管理和向量搜尋功能
• 查詢引擎工具

⚡ 高效能與輕量級

• 專為高效能資料操作設計
• 可擴展的架構

安裝與配置

環境要求

• Python 3.13+
• uv 包管理器
• Redis 伺服器

安裝步驟

# 克隆倉庫
git clone https://github.com/redis/mcp-redis.git
cd mcp-redis

# 使用 uv 安裝依賴
uv venv
source .venv/bin/activate
uv sync

環境變數配置

變數名	描述	預設值
REDIS_HOST	Redis IP 或主機名	"127.0.0.1"
REDIS_PORT	Redis 端口	6379
REDIS_USERNAME	資料庫使用者名稱	"default"
REDIS_PWD	資料庫密碼	""
REDIS_SSL	啟用/禁用 SSL/TLS	False
REDIS_CA_PATH	CA 證書路徑	None
REDIS_SSL_KEYFILE	客戶端私鑰檔案	None
REDIS_SSL_CERTFILE	客戶端證書檔案	None
REDIS_CERT_REQS	是否驗證伺服器證書	"required"
REDIS_CA_CERTS	受信任 CA 證書檔案路徑	None
REDIS_CLUSTER_MODE	啟用 Redis 集群模式	False
MCP_TRANSPORT	傳輸協定 (stdio/sse)	stdio

部署方式

1. 本地進程方式 (預設)

# 使用 stdio 傳輸
uv run src/main.py

2. 網路服務方式

# 設置 SSE 傳輸
export MCP_TRANSPORT="sse"
uv run src/main.py

# 測試伺服器
curl -i http://127.0.0.1:8000/sse

3. Docker 部署

# 構建鏡像
docker build -t mcp-redis .

# 運行容器
docker run --rm --name redis-mcp-server -i \
  -e REDIS_HOST=<redis_hostname> \
  -e REDIS_PORT=<redis_port> \
  -e REDIS_USERNAME=<redis_username> \
  -e REDIS_PWD=<redis_password> \
  mcp-redis

整合方式

Claude Desktop 整合

編輯 claude_desktop_config.json 檔案：

{
  "mcpServers": {
    "redis": {
      "command": "<uv 命令完整路徑>",
      "args": [
        "--directory",
        "<MCP 伺服器目錄>",
        "run",
        "src/main.py"
      ],
      "env": {
        "REDIS_HOST": "<Redis 主機名>",
        "REDIS_PORT": "<Redis 端口>",
        "REDIS_PWD": "<Redis 密碼>",
        "REDIS_SSL": true,
        "REDIS_CA_PATH": "<CA 證書路徑>"
      }
    }
  }
}

VS Code 整合

啟用代理模式並配置 mcp.json：

{
  "servers": {
    "redis": {
      "type": "stdio",
      "command": "<uv 命令完整路徑>",
      "args": [
        "--directory",
        "<MCP 伺服器目錄>",
        "run",
        "src/main.py"
      ],
      "env": {
        "REDIS_HOST": "<Redis 主機名>",
        "REDIS_PORT": "<Redis 端口>",
        "REDIS_USERNAME": "<Redis 使用者名稱>",
        "REDIS_PWD": "<Redis 密碼>"
      }
    }
  }
}

OpenAI 代理 SDK 整合

# 安裝 SDK
pip install openai-agents

# 配置 API 密鑰
export OPENAI_API_KEY="<openai_token>"

# 運行應用
python3.13 redis_assistant.py

自動化部署 (Smithery)

# 使用 Smithery 自動配置 Claude Desktop
npx -y @smithery/cli install @redis/mcp-redis --client claude

應用場景

🤖 AI 助手

• 讓大語言模型能夠獲取、儲存和處理 Redis 中的資料
• 實現智能資料管理和查詢

💬 聊天機器人和虛擬代理

• 檢索會話資料
• 管理訊息佇列
• 個性化回應

📈 資料搜尋與分析

• 實時洞察查詢
• 快速資料查找
• 向量相似性搜尋

🔄 事件處理

• 使用 Redis 流管理事件流
• 實時資料處理
• 事件溯源

調試和故障排除

MCP 檢查器

# 可視化調試
npx @modelcontextprotocol/inspector uv run src/main.py

日誌監控

# 監控 Claude 日誌
tail -f ~/Library/Logs/Claude/mcp-server-redis.log

OpenAI 儀表板

可以通過 OpenAI 儀表板 進行代理工作流故障排除。

開發與貢獻

貢獻流程

1. Fork 倉庫
2. 創建新分支 (feature-branch)
3. 提交更改
4. 推送到分支並提交 PR

技術棧

• 語言: Python 3.13+
• 包管理: uv
• 協定: MCP (Model Content Protocol)
• 資料庫: Redis
• 容器化: Docker

許可證與支援

• 許可證: MIT License
• 技術支援: 通過 GitHub Issues 獲取幫助

總結

Redis MCP 伺服器是一個強大的工具，它橋接了 AI 代理和 Redis 資料庫之間的 gap，通過自然語言介面使 AI 應用能夠更智能地管理和查詢資料。無論是構建智能助手、聊天機器人還是進行實時資料分析，這個項目都提供了一個可靠、高效的解決方案。

其模組化的設計、豐富的 Redis 資料結構支援以及多種部署方式，使其適用於從小型項目到企業級應用的各種場景。通過與 Claude、VS Code、OpenAI 等主流平台的整合，開發者可以輕鬆地將 Redis 的強大功能融入到他們的 AI 驅動應用中。

所有詳細資訊，請以官方網站公佈為準 (https://github.com/redis/mcp-redis)