Gongrzhe REDIS MCP Server

🚀 Redis 模型上下文協議 (MCP) 服務器 (@gongrzhe/server-redis-mcp@1.0.0)

這是一個 Redis 模型上下文協議 (MCP) 服務器實現，可與 Redis 數據庫進行交互。藉助一組標準化工具，該服務器能讓大型語言模型 (LLMs) 與 Redis 鍵值存儲實現交互。

🚀 快速開始

本服務器可通過不同方式進行安裝和使用，以下為您詳細介紹。

📦 安裝指南

使用 Smithery 進行安裝

若要通過 Smithery 自動為 Claude Desktop 安裝 Redis MCP 服務器，可使用以下命令：

npx -y @smithery/cli install @gongrzhe/server-redis-mcp --client claude

手動安裝

使用 npx 指定版本（推薦）

npx @gongrzhe/server-redis-mcp@1.0.0 redis://your-redis-host:port

# 示例：
npx @gongrzhe/server-redis-mcp@1.0.0 redis://localhost:6379

全局安裝指定版本

# 全局安裝指定版本
npm install -g @gongrzhe/server-redis-mcp@1.0.0

# 安裝後運行
@gongrzhe/server-redis-mcp redis://your-redis-host:port

✨ 主要特性

工具

• set
  • 功能：設置 Redis 鍵值對，可設置可選的過期時間。
  • 輸入：
    • key (字符串)：Redis 鍵。
    • value (字符串)：要存儲的值。
    • expireSeconds (數字, 可選)：過期時間（以秒為單位）。
• get
  • 功能：根據鍵從 Redis 中獲取值。
  • 輸入：key (字符串)：要檢索的 Redis 鍵。
• delete
  • 功能：刪除一個或多個 Redis 鍵。
  • 輸入：key (字符串 | 字符串數組)：鍵或鍵數組。
• list
  • 功能：根據模式列出匹配的 Redis 鍵。
  • 輸入：pattern (字符串, 可選)：要匹配的鍵模式（默認: *）。

📚 詳細文檔

配置

與 Claude Desktop 使用

若要在 Claude Desktop 應用中使用此服務器，需在 claude_desktop_config.json 文件的 "mcpServers" 部分添加以下配置：

{
  "mcpServers": {
    "redis": {
      "command": "npx",
      "args": [
        "@gongrzhe/server-redis-mcp@1.0.0",
        "redis://localhost:6379"
      ]
    }
  }
}

或者，如果您已安裝該包，則可以直接使用 node 命令：

{
  "mcpServers": {
    "redis": {
      "command": "node",
      "args": [
        "path/to/build/index.js",
        "redis://10.1.210.223:6379"
      ]
    }
  }
}

Docker 使用

使用 Docker 時：

• 對於 macOS，請在 Redis 服務器運行在主機網絡時使用 host.docker.internal。
• Redis URL 可以指定為參數，默認為 "redis://localhost:6379"。

{
  "mcpServers": {
    "redis": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-it",
        "redis:alpine",
        "redis-cli",
        "redis://host.docker.internal:6379"
      ]
    }
  }
}

構建與測試

要構建項目，請運行以下命令：

npm run build

然後使用以下命令啟動服務器：

node dist/index.js redis://localhost:6379

📄 許可證

請查看項目的許可證文件以獲取詳細信息。