Introdução

Instalação

Pré-requisitos: Python 3.10 ou posterior, Acesso a um armazenamento de dados Valkey uv

Configure seu cliente MCP: adicione o seguinte à configuração do cliente MCP:

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

<your-endpoint>Substitua pelo endpoint do seu armazenamento de dados Valkey. Seu agente de codificação deve ter acesso de rede ao endpoint.

Conectando-se à Amazon ElastiCache: Se o cache sem servidor do Valkey tiver um endpoint público, use o endereço do endpoint público como. VALKEY_HOST Nenhum túnel é necessário. A conexão requer TLS 1.3 e um token de autenticação do IAM. Para obter detalhes sobre como gerar o token, consulteConecte-se a um cache com um endpoint público.

Para todos os outros ElastiCache caches do Valkey, você não pode acessar o cache diretamente da sua máquina local. Para configuração de túnel SSM, geração de token de autenticação do IAM e tratamento de TLS no modo túnel, consulte o guia de ElastiCache conexão no kit de ferramentas do AWS agente ou instale o Amazon ElastiCache Skill para permitir que seu agente gerencie a configuração da conexão de ponta a ponta. Depois que o túnel for estabelecido, use VALKEY_HOST=127.0.0.1 na configuração acima.

Reinicie seu cliente MCP depois de salvar a configuração.

Você pode solicitar que seu agente verifique a conexão com:

Use o servidor Valkey MCP para verificar a conexão com meu armazenamento de dados e confirmar se as operações do Valkey estão disponíveis.

Configuração

Configure o servidor Valkey MCP por meio de variáveis de ambiente na configuração do cliente MCP. Você também pode usar o --readonly sinalizador para restringir o acesso do agente às operações somente para leitura.

Variável	Finalidade
VALKEY_HOST	Especifica o endpoint do seu armazenamento de dados Valkey. Use 127.0.0.1 ao se conectar a um ElastiCache cluster privado por meio de um túnel.
VALKEY_USE_SSL	Defina como true para habilitar o TLS. Isso é necessário para ElastiCache clusters com criptografia em trânsito ativada.
--readonly	Restringe o servidor ao nível de leitura e desativa todas as ferramentas administrativas e de gravação, tornando-o adequado para exploração de produção.
Parâmetros de pesquisa opcionais
EMBEDDINGS_PROVIDER	Seleciona o provedor de incorporação usado por e. add_documents search As opções suportadas são bedrock openaiollama,, hash e. Use hash para testes locais sem credenciais.
BEDROCK_MODEL_ID	Substitui o modelo de incorporação padrão do Amazon Bedrock.
OPENAI_API_KEY	Fornece a chave de API necessária quando EMBEDDING_PROVIDER está definida comoopenai.