Redis MCP Server (mcp-redis)

Redis 서버와 연동하여 LLM이 Key-Value 스토어를 직접 조회하고 제어(CRUD)할 수 있도록 지원하는 Model Context Protocol (MCP) 서버입니다.

기능 (MCP Tools)

주요 CRUD 기능

• redis_keys: 특정 패턴(예: *, user:*)에 매칭되는 키 목록 검색 (Read)
• redis_get: 특정 키의 String 값을 조회 (Read)
• redis_set: 특정 키에 String 값 저장 및 만료 시간(TTL) 설정 (Create/Update)
• redis_del: 특정 키 영구 삭제 (Delete)

고급 범용 제어 (List, Hash, Set 등)

• redis_command: 임의의 Redis 명령어를 직접 실행할 수 있는 범용 도구.
  • Hash(HSET, HGETALL), List(LPUSH, LRANGE), Set(SADD, SMEMBERS) 등 모든 Redis 자료구조에 대한 CRUD 작업을 수행할 때 사용됩니다.

진단 도구

• redis_info: Redis 서버의 메모리 리소스, 클라이언트 연결 수, 상태 등(INFO 명령어)을 조회

참고: 모든 도구와 파라미터 설명은 사용자 편의를 위해 **한국어(KR)와 영어(EN)**가 병기되어 있습니다.

실행 방법

로컬에서 npx를 사용하여 간편하게 실행할 수 있습니다. 단일 노드와 클러스터(Cluster) 모드를 모두 지원합니다.

1. 단일 노드 (Standalone) 모드

{
  "mcpServers": {
    "redis": {
      "command": "npx",
      "args": ["-y", "mcp-redis"],
      "env": {
        "REDIS_URL": "redis://localhost:6379",
        "REDIS_USERNAME": "your_user",
        "REDIS_PASSWORD": "your_password"
      }
    }
  }
}

2. 클러스터 (Cluster) 모드

여러 노드를 지정하여 클러스터 환경에 연결할 수 있습니다. (REDIS_CLUSTER_NODES 우선 적용)

{
  "mcpServers": {
    "redis-cluster": {
      "command": "npx",
      "args": ["-y", "mcp-redis"],
      "env": {
        "REDIS_CLUSTER_NODES": "redis://host1:7000,redis://host2:7001,redis://host3:7002",
        "REDIS_USERNAME": "your_user",
        "REDIS_PASSWORD": "your_password"
      }
    }
  }
}