redis/mcp-redis

The official Redis MCP Server is a natural language interface designed for agentic applications to manage and search data in Redis efficiently

Redis MCP Server – Redis로의 자연어 브리지

무엇인가요 – AI 에이전트가 일반 영어(또는 MCP 클라이언트가 지원하는 모든 언어)로 Redis와 대화할 수 있는 가벼운 Python 서버입니다. Model Content Protocol (MCP) 전송을 구현하여, 문자열, 해시, 리스트, 세트, 정렬된 세트, 스트림, JSON, pub/sub, 벡터 인덱스 등 Redis 데이터 구조에 직접 매핑되는 "도구" 세트를 공개합니다.

왜 중요한가요 – 현대의 LLM 기반 에이전트는 저수준 Redis 명령을 작성하지 않고도 데이터를 저장, 검색, 검색할 수 있는 방법이 필요합니다. "대화 내용을 스트림에 저장해" 또는 "이 벡터를 검색해" 와 같은 자연어 요청을 적절한 Redis 작업으로 변환함으로써, MCP 서버는 개발자가 에이전트 로직에 집중할 수 있도록 하며, 데이터베이스 상호작용, 인증, 확장은 서버가 처리합니다.

핵심 기능

기능	기능 설명
자연어 쿼리	에이전트는 일반 텍스트 의도를 전송하고, 서버가 이를 Redis 명령어로 번역합니다.
완전한 Redis 데이터형 지원	문자열, 해시(임베딩 벡터 포함), 리스트, 세트, 정렬된 세트, 스트림, JSON, pub/sub, 벡터 인덱스.
MCP 통합	어떤 MCP 클라이언트(예: Claude Desktop, OpenAI Agents SDK)와도 호환됩니다.
확장성 있고 가벼움	고처리량, 저오버헤드 설계; Docker 컨테이너에서 실행 가능합니다.
Azure Entra ID 인증	Azure Managed Redis용 네이티브 OAuth 토큰 처리(서비스 프린시팔, 관리형 ID, 기본 인증 흐름 지원).
CLI 및 환경 변수 구성	연결 옵션(호스트, 포트, TLS, ACL, 클러스터 모드)은 명령줄 플래그 또는 환경 변수로 설정 가능합니다.
확장 가능한 도구 세트	각 Redis 유형용 내장 도구에 더해, 문서 검색, 벡터 검색 관리, 서버 인스펙션용 헬퍼 도구도 제공됩니다.

시작하기 (빠른 시작)

설치 – pip install redis-mcp-server (또는 Docker 이미지 mcp/redis 사용).
실행 –
```
uv run redis-mcp-server --url redis://localhost:6379/0
```
(URI를 자신의 Redis 인스턴스로 바꾸세요; TLS 사용 시 rediss:// 사용)
클라이언트 구성 – Claude Desktop, OpenAI Agents SDK 등에서, 방금 시작한 명령을 가리키는 MCP 서버 항목을 추가하세요. 이제 클라이언트는 자연어 명령을 발행할 수 있으며, 서버가 Redis 작업으로 번역합니다.

일반적인 사용 사례

대화 메모리 – 대화의 각 단계를 Redis 스트림에 저장하여 나중에 검색하거나 재생할 수 있습니다.
세션 캐시 – string 도구를 사용해 만료 기한이 있는 LLM 응답을 캐시합니다.
벡터 검색 백엔드 – 에이전트에서 직접 벡터 인덱스를 생성하고 쿼리하여 의미적 검색을 수행합니다.
실시간 알림 – pub/sub 도구를 통해 이벤트를 게시하고, 에이전트가 업데이트를 구독할 수 있도록 합니다.
엔터프라이즈 Azure 배포 – 정적 비밀번호를 피하고 Entra ID로 Azure Managed Redis에 인증합니다.

설치 옵션

방법	사용 방법
PyPI (권장)	`pip install redis-mcp-server` 후 `uv run redis-mcp-server …`로 실행
GitHub 소스	`uvx --from git+https://github.com/redis/mcp-redis.git redis-mcp-server --url redis://…`
Docker	`docker run --rm -e REDIS_HOST=… -e REDIS_PORT=… mcp/redis`
개발용	리포지토리 복제 후 `uv venv && uv sync`, 이후 `uv run src/main.py`

구성 요약

CLI 플래그 – --url, --host, --port, --ssl, --cluster-mode 등
환경 변수 – REDIS_HOST, REDIS_PORT, REDIS_PWD, REDIS_SSL, REDIS_CLUSTER_MODE 외에도 Entra ID 변수(REDIS_ENTRAID_*)
ACL 지원 – 표준 Redis ACL 명령어로 서버를 읽기 전용 Redis 사용자로 제한 가능

생태계 통합

OpenAI Agents SDK – OpenAI 기반 에이전트의 도구 제공자로 사용 가능.
Claude Desktop – Claude의 mcpServers JSON 블록에 MCP 서버 설정.
VS Code + GitHub Copilot – 로컬에서 서버를 실행하고 Copilot 기반 에이전트가 데이터 저장/검색 가능.
Augment – (README에 기재됨) – MCP 서버의 도구를 호출할 수 있는 고수준 프레임워크.

도움 받기

Discord: https://discord.gg/redis
GitHub Issues / Discussions
Stack Overflow 태그 mcp-redis
문서 – README 자체, 그리고 https://modelcontextprotocol.io의 MCP 사양

라이선스

MIT – 상용 및 비상용 모두 자유롭게 사용 가능.

결론 – Redis MCP Server는 LLM 기반 에이전트가 Redis를 자연어로 접근 가능한 지식 저장소로 사용할 수 있도록 해주는 프로덕션 준비된 브리지이며, Azure 기반의 보안 인증과 Redis의 모든 네이티브 데이터 구조를 완전히 지원합니다.