기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

시작하기

설치

사전 조건: Python 3.10 이상, uv, Valkey 데이터 스토어에 대한 액세스

MCP 클라이언트 구성: MCP 클라이언트 구성에 다음을 추가합니다.

{
  "mcpServers": {
    "valkey": {
      "command": "uvx",
      "args": ["awslabs.valkey-mcp-server@latest"],
      "env": {
        "VALKEY_HOST": "<your-endpoint>",
        "VALKEY_USE_SSL": "true"
      }
    }
  }
}

를 Valkey 데이터 스토어의 엔드포인트<your-endpoint>로 바꿉니다. 코딩 에이전트는 엔드포인트에 대한 네트워크 액세스 권한이 있어야 합니다.

Amazon ElastiCache에 연결: Valkey 서버리스 캐시에 퍼블릭 엔드포인트가 있는 경우 퍼블릭 엔드포인트 주소를 로 사용합니다VALKEY_HOST. 터널이 필요하지 않습니다. 연결에는 TLS 1.3과 IAM 인증 토큰이 필요합니다. 토큰 생성에 대한 자세한 내용은 섹션을 참조하세요퍼블릭 엔드포인트를 사용하여 캐시에 연결.

다른 모든 ElastiCache for Valkey 캐시의 경우 로컬 시스템에서 직접 캐시에 연결할 수 없습니다. SSM 터널 설정, IAM 인증 토큰 생성 및 터널 모드의 TLS 처리는 AWS Agent Toolkit의 ElastiCache 연결 가이드를 참조하거나 Amazon ElastiCache Skill을 설치하여 에이전트가 연결 설정을 end-to-end 처리할 수 있도록 합니다. 터널이 설정되면 위의 구성VALKEY_HOST=127.0.0.1에서를 사용합니다.

구성을 저장한 후 MCP 클라이언트를 다시 시작합니다.

에이전트에게 다음과의 연결을 확인하라는 메시지를 표시할 수 있습니다.

Valkey MCP 서버를 사용하여 내 데이터 스토어에 대한 연결을 확인하고 Valkey 작업을 사용할 수 있는지 확인합니다.

구성

MCP 클라이언트 구성의 환경 변수를 통해 Valkey MCP 서버를 구성합니다. --readonly 플래그를 사용하여 에이전트 액세스를 읽기 전용 작업으로 제한할 수도 있습니다.