Redis CRUD MCP 서버

이것은 Redis 데이터베이스 작업을 위한 MCP (Model Context Protocol) 서버 플러그인으로, 완전한 CRUD 작업 도구를 제공합니다.

✨ 특징

• 🔍 프로젝트 구성 자동 감지 - .env 파일을 상위로 검색하여 프로젝트 루트 디렉토리 위치 파악

• 🔄 다중 프로젝트 지원 - 서로 다른 프로젝트에서 자동으로 서로 다른 Redis 연결 사용

• ⏱️ 연결 시간 초과 보호 - 기본 10초 시간 초과, 환경 변수를 통해 구성 가능

• 📝 다양한 구성 형식 - INI 섹션 및 KEY=VALUE 두 가지 형식 지원

• 🛠️ 다중 도구 호환 - Claude Code, Cline, Codex 등 지원

🚀 빠른 시작

전역 설치 (권장)

npm install -g redis-crud-server

MCP 구성

프로젝트 루트 디렉토리에 .mcp.json을 생성합니다:

{
  "mcpServers": {
    "redis-crud": {
      "command": "redis-crud-server"
    }
  }
}

⚙️ 구성 설명

구성 형식 1: INI 섹션 형식

[REDIS]
REDIS_HOSTNAME = 127.0.0.1
PORT = 6379
REDIS_PASSWORD = your_password
SELECT = 0

구성 형식 2: KEY=VALUE 형식

REDIS_HOST=127.0.0.1
REDIS_PORT=6379
REDIS_PASSWORD=your_password

지원되는 구성 이름

🔧 도구 목록

문자열 작업

• redis_set - 문자열 키-값 설정

• redis_get - 문자열 키-값 가져오기

• redis_del - 키 삭제

• redis_exists - 키 존재 여부 확인

해시 작업

• redis_hset - 해시 필드 설정

• redis_hget - 해시 필드 가져오기

• redis_hgetall - 해시의 모든 필드 가져오기

• redis_hdel - 해시 필드 삭제

정보

• redis_info - 연결 정보 가져오기

⏱️ 시간 초과 구성

기본 연결 시간 초과는 10초이며, 환경 변수를 통해 구성할 수 있습니다:

{
  "mcpServers": {
    "redis-crud": {
      "command": "redis-crud-server",
      "env": {
        "REDIS_TIMEOUT": "30000"
      }
    }
  }
}

📝 사용 예시

키-값 설정

redis_set: key=test_key, value=hello_world

키-값 가져오기

redis_get: key=test_key

해시 작업

redis_hset: key=user:1, field=name, value=张三
redis_hget: key=user:1, field=name
redis_hgetall: key=user:1

🐛 문제 해결

연결 시간 초과

• 네트워크 연결 및 방화벽 설정 확인

• Redis 서버에 액세스할 수 있는지 확인

• REDIS_TIMEOUT 환경 변수 조정

구성 파일을 찾을 수 없음

• .env 파일이 프로젝트 루트 디렉토리에 있는지 확인

• MCP는 자동으로 상위 디렉토리에서 .env 파일을 검색합니다

INI 형식 파싱 실패

• 올바른 섹션 이름 [REDIS]를 사용했는지 확인

• Windows (\r\n), Unix (\n) 및 구형 Mac (\r) 줄 바꿈 지원

📄 라이선스

MIT