AWS S3 MCP Server

MCP Server per a operacions amb AWS S3, que ofereix accés segur a buckets S3 mitjançant URLs pre-signades.

Tools

1. list_objects

   • Lista els objectes d'un bucket S3
   • Entrada:
     • prefix (string, optional): Filtre de prefix per a les claus d'objecte
   • Retorna: Array d'objectes amb claus, mides i dates d'última modificació

2. get_object

   • Genera una URL pre-signada per accedir a un objecte
   • Entrades:
     • key (string, required): Clau de l'objecte a recuperar
     • expiry (number, optional): Temps d'expiració de la URL en segons (per defecte: 3600)
   • Retorna: object_url que conté la URL pre-signada

3. put_object

   • Genera una URL pre-signada per pujar un objecte
   • Entrades:
     • key (string, required): Clau de l'objecte a pujar
     • expiry (number, optional): Temps d'expiració de la URL en segons (per defecte: 3600)
   • Retorna: upload_url que conté la URL pre-signada

4. delete_object

   • Elimina un objecte del bucket
   • Entrada:
     • key (string, required): Clau de l'objecte a eliminar
   • Retorna: success booleà que indica l'estat de l'eliminació

Setup

Environment Variables

El servidor requereix les següents variables d'entorn:

• BUCKET_NAME: Nom del teu bucket S3 (obligatori)
• REGION: Regió d'AWS (per defecte: "ap-southeast-1")

Les credencials d'AWS s'han de configurar mitjançant els mètodes estàndard de configuració de credencials d'AWS (variables d'entorn, rols IAM o fitxer de credencials d'AWS).

Usage with Claude Desktop

Afegeix el següent al teu 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>"
      }
    }
  }
}

NPX Command

{
  "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

Construcció amb Docker:

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

Development

El servidor està construït amb:

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

License

Aquest servidor MCP està llicenciat sota la MIT License. Això vol dir que pots utilitzar, modificar i distribuir el programari lliurement, subjecte als termes i condicions de la MIT License. Per a més detalls, consulta el fitxer LICENSE al repositori del projecte.