Servidor MCP de AWS S3

Servidor MCP para operaciones de AWS S3, que proporciona acceso seguro a los buckets S3 a través de URL previamente firmadas.

Herramientas

1. list_objects

   • Enumerar objetos en un bucket de S3

   • Aporte:

     • prefix (cadena, opcional): filtro de prefijo para claves de objeto

   • Devuelve: Matriz de objetos con claves, tamaños y fechas de última modificación

2. get_object

   • Generar una URL firmada previamente para acceder a un objeto

   • Entradas:

     • key (cadena, obligatoria): clave del objeto a recuperar

     • expiry (número, opcional): tiempo de expiración de la URL en segundos (predeterminado: 3600)

   • Devuelve: object_url que contiene la URL firmada previamente

3. put_object

   • Generar una URL firmada previamente para cargar un objeto

   • Entradas:

     • key (cadena, obligatoria): Clave del objeto a cargar

     • expiry (número, opcional): tiempo de expiración de la URL en segundos (predeterminado: 3600)

   • Devuelve: upload_url que contiene la URL firmada previamente

4. delete_object

   • Eliminar un objeto del depósito

   • Aporte:

     • key (cadena, obligatoria): clave del objeto a eliminar

   • Devuelve: booleano success que indica el estado de eliminación

Related MCP server: S3 MCP Server

Configuración

Variables de entorno

El servidor requiere las siguientes variables de entorno:

• BUCKET_NAME : El nombre de su depósito S3 (obligatorio)

• REGION : Región de AWS (predeterminada: "ap-southeast-1")

Las credenciales de AWS deben configurarse utilizando los métodos de configuración de credenciales de AWS estándar (variables de entorno, roles de IAM o archivo de credenciales de AWS).

Uso con Claude Desktop

Agregue lo siguiente a su 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>"
      }
    }
  }
}

Construir

Compilación de Docker:

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

Desarrollo

El servidor está construido utilizando:

• Node.js

• Mecanografiado

• @modelcontextprotocol/sdk

• @aws-sdk/cliente-s3

• @aws-sdk/s3-request-presigner

Licencia

Este servidor MCP cuenta con la licencia MIT. Esto significa que puede usar, modificar y distribuir el software libremente, sujeto a los términos y condiciones de la licencia MIT. Para más detalles, consulte el archivo de licencia en el repositorio del proyecto.