링크된 문서
Redis
Redis
Redis MCP 서버는 LLM이 Redis 키-값 저장소와 직접 상호작용할 수 있게 해주는 Model Context Protocol 서버입니다. 이 서버는 인메모리 데이터 작업을 위한 표준화된 도구 세트를 제공합니다.
특징
- Redis 데이터베이스 및 AWS MemoryDB와의 완벽한 통합
- 키-값 작업을 위한 포괄적인 도구 세트
- 패턴 기반 키 목록 조회
- 만료 시간 설정 및 관리
- 다양한 Redis 데이터 구조 지원 (문자열, 목록, 세트, 해시 등)
- Docker 컨테이너 지원
- 자연어 기반 상호작용 가능
주요 도구
기본 키-값 작업
- setKey: Redis 키-값 쌍 설정 (선택적 만료 시간 지원)
- getKey: 키에 해당하는 값 검색
- deleteKey: 키 삭제
- exists: 키 존재 여부 확인
- expireKey: 키의 만료 시간 설정
- ttl: 키의 남은 만료 시간 조회
키 관리 도구
- listKeys: 패턴에 맞는 키 목록 조회
- renameKey: 키 이름 변경
- randomKey: 무작위 키 검색
- keyType: 키의 데이터 타입 검색
문자열 작업
- append: 문자열 값에 추가
- strLen: 문자열 길이 반환
- incrBy: 숫자 값 증가
- decrBy: 숫자 값 감소
- setRange: 문자열의 특정 범위 변경
- getRange: 문자열의 특정 범위 검색
리스트 작업
- lPush: 리스트 왼쪽에 값 추가
- rPush: 리스트 오른쪽에 값 추가
- lPop: 리스트 왼쪽에서 값 제거 및 반환
- rPop: 리스트 오른쪽에서 값 제거 및 반환
- lRange: 리스트 범위 검색
- lLen: 리스트 길이 반환
집합 작업
- sAdd: 집합에 멤버 추가
- sMembers: 집합의 모든 멤버 반환
- sRem: 집합에서 멤버 제거
- sIsMember: 멤버가 집합에 속하는지 확인
- sCard: 집합의 크기 반환
해시 작업
- hSet: 해시에 필드 설정
- hGet: 해시에서 필드 값 검색
- hGetAll: 해시의 모든 필드와 값 검색
- hDel: 해시에서 필드 삭제
- hExists: 해시에 필드가 존재하는지 확인
설치 및 사용 방법
Claude Desktop 구성
Claude Desktop에서 Redis MCP 서버를 사용하기 위한 구성:
{
"mcpServers": {
"redis": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-redis",
"redis://localhost:6379"
]
}
}
}
또는 환경 변수를 사용하는 방법:
{
"mcpServers": {
"redis": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-redis"
],
"env": {
"REDIS_URL": "redis://localhost:6379"
}
}
}
}
Docker 사용
Docker를 통한 Redis MCP 서버 실행:
{
"mcpServers": {
"redis": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"mcp/redis",
"redis://host.docker.internal:6379"
]
}
}
}
Smithery를 통한 자동 설치
Smithery를 사용하여 Claude Desktop용 Redis MCP 서버를 자동으로 설치:
npx -y @smithery/cli install @redis/mcp-redis --client claude
주요 용도
Redis MCP 서버의 주요 활용 사례:
- 세션 데이터 관리: 사용자 세션 정보 저장 및 검색
- 캐싱: 자주 액세스하는 데이터를 빠르게 캐싱하여 성능 향상
- 실시간 분석: 실시간 데이터 처리 및 분석
- 메시지 큐 관리: 메시지 큐 관리 및 이벤트 처리
- LLM 컨텍스트 저장: 대화 컨텍스트 유지 및 저장
- 레이트 리미팅: API 호출 제한 및 관리
- 임시 데이터 저장: 임시 데이터 관리 및 자동 만료
프롬프트 예시
Redis MCP 서버와 상호작용하기 위한 예시 프롬프트:
- "사용자 세션 정보를 Redis에 저장해주세요"
- "user:1234 키의 값을 조회해주세요"
- "제품 재고 정보를 Redis에서 업데이트해주세요"
- "지난 5분 동안의 로그인 시도 횟수를 증가시켜주세요"
- "모든 활성 사용자 세션 목록을 가져와주세요"
- "사용자 ID로 시작하는 모든 키를 찾아주세요"
- "이 세션 키를 30분 후에 만료되도록 설정해주세요"
- "최근 검색어 목록에 새 항목을 추가해주세요"
연결된 구성 요소
- MongoDB - NoSQL 문서 기반 데이터베이스 서버
- Neo4j - 그래프 데이터베이스 서버
- Elasticsearch - 검색 엔진 데이터베이스 서버
- PostgreSQL - 관계형 데이터베이스 서버