Redis MCP Server

Um servidor MCP para interagir com bancos de dados Redis, permitindo que LLMs acessem armazenamentos chave-valor.

Documentação

Redis MCP Server (@gongrzhe/server-redis-mcp@1.0.0)

smithery badge

Uma implementação de servidor Redis Model Context Protocol (MCP) para interagir com bancos de dados Redis. Este servidor permite que LLMs interajam com armazenamentos de chave-valor Redis por meio de um conjunto de ferramentas padronizadas.

Atualização

62 ferramentas Redis MCP em https://github.com/GongRzhe/REDIS-MCP-Server/tree/redis-plus

Instalação e Uso

Instalação via Smithery

Para instalar o Redis MCP Server para Claude Desktop automaticamente via Smithery:

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

Instalação Manual

# Using npx with specific version (recommended)
npx @gongrzhe/server-redis-mcp@1.0.0 redis://your-redis-host:port

# Example:
npx @gongrzhe/server-redis-mcp@1.0.0 redis://localhost:6379

Ou instale globalmente:

# Install specific version globally
npm install -g @gongrzhe/server-redis-mcp@1.0.0

# Run after global installation
@gongrzhe/server-redis-mcp redis://your-redis-host:port

Componentes

Ferramentas

  • set

    • Define um par chave-valor Redis com expiração opcional
    • Entrada:
      • key (string): chave Redis
      • value (string): valor a ser armazenado
      • expireSeconds (número, opcional): tempo de expiração em segundos
  • get

    • Obtém o valor pela chave do Redis
    • Entrada: key (string): chave Redis a ser recuperada
  • delete

    • Exclui uma ou mais chaves do Redis
    • Entrada: key (string | string[]): chave ou array de chaves a serem excluídas
  • list

    • Lista chaves Redis que correspondem a um padrão
    • Entrada: pattern (string, opcional): padrão para corresponder às chaves (padrão: *)

Configuração

Uso com Claude Desktop

Para usar este servidor com o aplicativo Claude Desktop, adicione a seguinte configuração à seção "mcpServers" do seu claude_desktop_config.json:

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

Alternativamente, você pode usar o comando node diretamente se tiver o pacote instalado:

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

Uso com Docker

Ao usar Docker:

  • Para macOS, use host.docker.internal se o servidor Redis estiver rodando na rede do host
  • A URL do Redis pode ser especificada como argumento, com padrão "redis://localhost:6379"
{
  "mcpServers": {
    "redis": {
      "command": "docker",
      "args": [
        "run", 
        "-i", 
        "--rm", 
        "mcp/redis", 
        "redis://host.docker.internal:6379"
      ]
    }
  }
}

Desenvolvimento

Compilando a partir do Código Fonte

  1. Clone o repositório
  2. Instale as dependências:
    npm install
    
  3. Compile o projeto:
    npm run build
    

Build Docker

docker build -t mcp/redis .

Licença

Este servidor MCP é licenciado sob a Licença ISC. Para mais detalhes, consulte o arquivo LICENSE no repositório do projeto.