Redis MCP 서버

개요

Redis MCP 서버는 에이전트 애플리케이션이 Redis에서 데이터를 효율적으로 관리하고 검색할 수 있도록 설계된 자연어 인터페이스 입니다. MCP(모델 콘텐츠 프로토콜) 클라이언트 와 완벽하게 통합되어 AI 기반 워크플로가 Redis의 정형 및 비정형 데이터와 상호 작용할 수 있도록 지원합니다. 이 MCP 서버를 사용하면 다음과 같은 질문을 할 수 있습니다.

"대화 전체를 스트림에 저장"
"이 항목을 캐시합니다"
"만료 시간을 지정하여 세션을 저장합니다"
"이 벡터를 인덱싱하고 검색하세요"

특징

자연어 쿼리 : AI 에이전트가 자연어를 사용하여 Redis를 쿼리하고 업데이트할 수 있도록 합니다.
원활한 MCP 통합 : 원활한 커뮤니케이션을 위해 모든 MCP 클라이언트 와 작동합니다.
전체 Redis 지원 : 해시, 목록, 세트, 정렬된 세트, 스트림 등을 처리합니다.
검색 및 필터링 : Redis에서 효율적인 데이터 검색 및 검색을 지원합니다.
확장성 및 경량성 : 고성능 데이터 작업을 위해 설계되었습니다.

도구

이 MCP 서버는 Redis에 저장된 데이터를 관리하는 도구를 제공합니다.

만료일이 포함된 문자열을 설정하고 가져오는 string 도구입니다. 간단한 설정 값, 세션 데이터 저장 또는 응답 캐싱에 유용합니다.
단일 키 내에 필드-값 쌍을 저장하는 hash 도구입니다. 해시는 벡터 임베딩을 저장할 수 있습니다. 여러 속성을 가진 객체, 사용자 프로필 또는 필드에 개별적으로 액세스할 수 있는 제품 정보를 표현하는 데 유용합니다.
항목을 추가하고 삭제하는 일반적인 작업을 수행하는 도구 list . 대기열, 메시지 브로커 또는 최근 작업 목록 유지 관리에 유용합니다.
집합 구성원을 추가, 제거 및 나열하는 set 도구입니다. 사용자 ID나 태그와 같은 고유 값을 추적하고 교집합과 같은 집합 연산을 수행하는 데 유용합니다.
리더보드, 우선순위 대기열 또는 점수 기반 순서를 갖춘 시간 기반 분석을 위한 데이터를 관리하기 위한 sorted set 도구입니다.
채널에 메시지를 게시하고 구독하여 수신할 수 있는 pub/sub 기능입니다. 실시간 알림, 채팅 애플리케이션 또는 여러 클라이언트에 업데이트 배포에 유용합니다.
데이터 스트림에 추가, 읽기, 삭제를 위한 streams 도구입니다. 이벤트 소싱, 활동 피드 또는 소비자 그룹 지원을 통한 센서 데이터 로깅에 유용합니다.
Redis에서 JSON 문서를 저장, 검색 및 조작하는 JSON 도구입니다. 복잡한 중첩 데이터 구조, 문서 데이터베이스 또는 경로 기반 액세스를 통한 구성 관리에 유용합니다.

추가 도구.

벡터 인덱스를 관리하고 벡터 검색을 수행하는 query engine 도구
데이터베이스에 대한 정보를 검색하는 server management 도구

설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop에 Redis MCP 서버를 자동으로 설치하려면:

지엑스피1

수동 설치

# Clone the repository
git clone https://github.com/redis/mcp-redis.git
cd mcp-redis

# Install dependencies using uv
uv venv
source .venv/bin/activate
uv sync

구성

이 Redis MCP 서버를 구성하려면 다음 환경 변수를 고려하세요.

이름	설명	기본값
`REDIS_HOST`	Redis IP 또는 호스트 이름	`"127.0.0.1"`
`REDIS_PORT`	레디스 포트	`6379`
`REDIS_USERNAME`	기본 데이터베이스 사용자 이름	`"default"`
`REDIS_PWD`	기본 데이터베이스 비밀번호	""
`REDIS_SSL`	SSL/TLS를 활성화하거나 비활성화합니다.	`False`
`REDIS_CA_PATH`	서버 확인을 위한 CA 인증서	없음
`REDIS_SSL_KEYFILE`	클라이언트 인증을 위한 클라이언트의 개인 키 파일	없음
`REDIS_SSL_CERTFILE`	클라이언트 인증을 위한 클라이언트 인증서 파일	없음
`REDIS_CERT_REQS`	클라이언트가 서버의 인증서를 검증해야 하는지 여부	`"required"`
`REDIS_CA_CERTS`	신뢰할 수 있는 CA 인증서 파일에 대한 경로	없음
`REDIS_CLUSTER_MODE`	Redis 클러스터 모드 활성화	`False`

OpenAI Agents SDK와 통합

이 MCP 서버를 OpenAI Agents SDK와 통합하세요. SDK와 MCP 통합에 대한 자세한 내용은 문서를 참조하세요.

Python SDK를 설치합니다.

pip install openai-agents

OpenAI 토큰을 구성하세요.

export OPENAI_API_KEY="<openai_token>"

그리고 애플리케이션을 실행하세요.

python3.13 redis_assistant.py 

OpenAI 대시보드를 사용하여 에이전트 워크플로 문제를 해결할 수 있습니다.

Claude Desktop과 통합

이 MCP 서버를 사용하도록 Claude Desktop을 구성할 수 있습니다.

Redis 자격 증명과 TLS 구성을 지정하세요
uv 명령 전체 경로(예: which uv )를 검색합니다.
claude_desktop_config.json 구성 파일을 편집합니다.
- MacOS의 경우 ~/Library/Application\ Support/Claude/

{
    "mcpServers": {
        "redis": {
            "command": "<full_path_uv_command>",
            "args": [
                "--directory",
                "<your_mcp_server_directory>",
                "run",
                "src/main.py"
            ],
            "env": {
                "REDIS_HOST": "<your_redis_database_hostname>",
                "REDIS_PORT": "<your_redis_database_port>",
                "REDIS_PSW": "<your_redis_database_password>",
                "REDIS_SSL": True|False,
                "REDIS_CA_PATH": "<your_redis_ca_path>",
                "REDIS_CLUSTER_MODE": True|False
            }
        }
    }
}

로그 파일을 추적하여 문제를 해결할 수 있습니다.

tail -f ~/Library/Logs/Claude/mcp-server-redis.log

테스트

MCP Inspector를 사용하면 MCP 서버의 시각적 디버깅을 수행할 수 있습니다.

npx @modelcontextprotocol/inspector uv run src/main.py

예시 사용 사례

AI 어시스턴트 : LLM이 Redis에서 데이터를 가져오고, 저장하고, 처리할 수 있도록 지원합니다.
챗봇 및 가상 에이전트 : 세션 데이터를 검색하고, 대기열을 관리하고, 응답을 개인화합니다.
데이터 검색 및 분석 : 실시간 통찰력과 빠른 조회를 위해 Redis를 쿼리합니다.
이벤트 처리 : Redis Streams를 사용하여 이벤트 스트림을 관리합니다.

기여하다

저장소를 포크하세요
새로운 브랜치( feature-branch )를 생성합니다.
변경 사항을 커밋하세요
지점에 가서 PR을 제출하세요!

특허

이 프로젝트는 MIT 라이선스 에 따라 라이선스가 부여되었습니다.

연락하다

질문이나 지원이 필요하면 GitHub Issues를 통해 문의하세요.

Redis MCP Server

Integrations