MCP Server Redis

🚀 mcp-server-redis項目

mcp-server-redis項目提供了一個與Redis交互的服務器，能方便地進行各種Redis操作，如連接管理、數據讀寫等，為使用Redis提供了便捷的解決方案。

🚀 快速開始

項目結構

項目的整體結構如下：

mcp-server-redis/
├── src/
│   ├── __init__.py
│   ├── main.py           # 主程序入口
│   ├── config.py         # 配置文件
│   ├── connection.py     # Redis連接管理
│   ├── resources/        # 資源實現
│   │   ├── __init__.py
│   │   ├── status.py     # 連接狀態資源
│   │   └── keys.py       # 關鍵字相關資源
│   └── tools/           # 工具實現
│       ├── __init__.py
│       ├── basic.py     # 基本Redis操作
│       ├── lists.py     # 列表操作
│       ├── hashes.py    # 哈希表操作
│       ├── sets.py      # 集合操作
│       └── pubsub.py    # 發佈/訂閱操作
├── tests/              # 測試目錄
│   └── __init__.py
├── README.md
└── pyproject.toml

安裝依賴

安裝所需的依賴項： [如果尚未安裝] https://docs.astral.sh/uv/

uv venv
source .venv/bin/activate
uv sync

配置Redis連接

參考.env.example文件以配置Redis連接，添加相應的變量。

運行服務器

python src/server.py

✨ 主要特性

服務器功能

資源

• redis://status - 當前連接狀態
• redis://info - Redis服務器信息
• redis://keys/{pattern} - 匹配模式的鍵列表

工具

• 基本操作：
  • get_value - 獲取值
  • set_value - 設置值，帶可選過期時間
  • delete_key - 刪除關鍵字
  • increment - 增加數值
• 列表操作：
  • list_push - 將值推送到列表中
  • list_range - 獲取列表中的範圍值
• 哈希表操作：
  • hash_set - 設置哈希字段
  • hash_get - 獲取哈希字段
• 集合操作：
  • set_add - 添加到集合
  • set_members - 獲取集合成員
• 發佈/訂閱：
  • publish_message - 發佈消息

每個工具都包含錯誤處理，並返回有意義的響應。如果連接丟失，服務器會自動重新連接。

💻 使用示例

測試方法

你可以使用MCP Inspector進行測試：

mcp dev src/server.py

或在Claude Desktop中安裝：

mcp install src/server.py

交互示例

用戶：Redis當前連接狀態如何？
LLM：讓我檢查一下Redis的連接狀態。

[讀取資源 redis://status]

Redis服務器目前正在localhost:6379上運行，數據庫0已連接。

用戶：你能把我的名字“愛麗絲”存入Redis嗎？
LLM：我將使用set_value工具幫你存儲名字。

[調用set_value，鍵="name"，值="Alice"]
成功設置鍵'nam'為"Alice"

我已經將你的名字“Alice”存儲在Redis的"name"關鍵字下。是否需要確認存儲是否正確？

用戶：請驗證一下
LLM：我將使用get_value工具進行驗證。

[調用get_value，鍵="name"]
Alice

是的，我可以確認“Alice”已被成功存儲在Redis中，並且可以正確檢索到。存儲和檢索的值完全一致。

📚 詳細文檔

此實現為Redis集成提供了堅實的基礎。你可以根據具體需求添加更多Redis命令來擴展功能。