AWS S3 MCP Server

Servidor MCP AWS S3

Servidor MCP para operações AWS S3, fornecendo acesso seguro a buckets S3 por meio de URLs pré-assinadas.

Ferramentas

1. list_objects

   • Lista objetos em um bucket S3
   • Entrada:
     • prefix (string, opcional): Filtro de prefixo para chaves de objetos
   • Retorna: Matriz de objetos com chaves, tamanhos e datas da última modificação

2. get_object

   • Gera uma URL pré-assinada para acessar um objeto
   • Entradas:
     • key (string, obrigatório): Chave do objeto a recuperar
     • expiry (número, opcional): Tempo de expiração da URL em segundos (padrão: 3600)
   • Retorna: object_url contendo a URL pré-assinada

3. put_object

   • Gera uma URL pré-assinada para enviar um objeto
   • Entradas:
     • key (string, obrigatório): Chave do objeto a enviar
     • expiry (número, opcional): Tempo de expiração da URL em segundos (padrão: 3600)
   • Retorna: upload_url contendo a URL pré-assinada

4. delete_object

   • Exclui um objeto do bucket
   • Entrada:
     • key (string, obrigatório): Chave do objeto a excluir
   • Retorna: success booleano indicando o status da exclusão

Configuração

Variáveis de Ambiente

O servidor requer as seguintes variáveis de ambiente:

• BUCKET_NAME: O nome do seu bucket S3 (obrigatório)
• REGION: Região AWS (padrão: "ap-southeast-1")

As credenciais AWS devem ser configuradas usando os métodos padrão de configuração de credenciais AWS (variáveis de ambiente, funções IAM ou arquivo de credenciais AWS).

Uso com Claude Desktop

Adicione o seguinte ao seu claude_desktop_config.json:

{
  "mcpServers": {
    "aws-ow-s3-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "BUCKET_NAME",
        "-e",
        "REGION",
        "-e",
        "AWS_ACCESS_KEY_ID",
        "-e",
        "AWS_SECRET_ACCESS_KEY",
        "mcp/aws-ow-s3-mcp"
      ],
      "env": {
        "BUCKET_NAME": "<YOUR_BUCKET_NAME>",
        "REGION": "<AWS_REGION>",
        "AWS_ACCESS_KEY_ID": "<YOUR_ACCESS_KEY>",
        "AWS_SECRET_ACCESS_KEY": "<YOUR_SECRET_KEY>"
      }
    }
  }
}

Comando NPX

{
  "mcpServers": {
    "aws-ow-s3-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-aws-ow-s3-mcp"
      ],
      "env": {
        "BUCKET_NAME": "<YOUR_BUCKET_NAME>",
        "REGION": "<AWS_REGION>",
        "AWS_ACCESS_KEY_ID": "<YOUR_ACCESS_KEY>",
        "AWS_SECRET_ACCESS_KEY": "<YOUR_SECRET_KEY>"
      }
    }
  }
}

Build

Build Docker:

docker build -t mcp/aws-ow-s3-mcp-server .

Desenvolvimento

O servidor é construído usando:

• Node.js
• TypeScript
• @modelcontextprotocol/sdk
• @aws-sdk/client-s3
• @aws-sdk/s3-request-presigner

Licença

Este servidor MCP é licenciado sob a Licença MIT. Isso significa que você é livre para usar, modificar e distribuir o software, sujeito aos termos e condições da Licença MIT. Para mais detalhes, consulte o arquivo LICENSE no repositório do projeto.