Servidor MCP de AWS S3

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

Herramientas

1. list_objects

   • Listar objetos en un bucket de S3
   • Entrada
     • prefix (cadena, opcional): Filtro de prefijo para las claves de los objetos
   • Devuelve: Array de objetos con claves, tamaños y fechas de última modificación

2. obtener_objeto

   • Genera una URL pre-firmada para acceder a un objeto
   • Entradas
     • clave (cadena, obligatorio): Clave del objeto a recuperar
     • expiry (número, opcional): Tiempo de expiración de la URL en segundos (por defecto: 3600)
   • Devuelve: object_url que contiene la URL pre-firmada

3. poner_objeto

   • Generar una URL pre-firmada para subir un objeto
   • Entradas
     • key (cadena, obligatorio): Clave del objeto a subir
     • expiry (número, opcional): Tiempo de expiración de la URL en segundos (por defecto: 3600)
   • Devuelve: upload_url que contiene la URL pre-firmada

4. borrar_objeto

   • Eliminar un objeto del cubo
   • Entrada
     • clave (cadena, obligatoria): Clave del objeto a borrar
   • Devuelve: booleano de éxito que indica el estado del borrado

Configuración

Variables de entorno

El servidor requiere las siguientes variables de entorno:

• BUCKET_NAME: El nombre de tu bucket de S3 (obligatorio)
• REGION: Región de AWS (por defecto: "ap-southeast-1")

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

Uso con Claude Desktop

Añada 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": "<TU_CLAVE_DE_ACCESO>", "AWS_SECRET_ACCESS_KEY": "<SU_CLAVE_SECRETA>" } } }

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": "<TU_CLAVE_DE_ACCESO>", "AWS_SECRET_ACCESS_KEY": "<SU_CLAVE_SECRETA>" } } }

Compilación

Docker build:

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

Desarrollo

El servidor se construye utilizando:

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

Licencia

Este servidor MCP está licenciado bajo la Licencia MIT. Esto significa que usted es libre de usar, modificar y distribuir el software, sujeto a los términos y condiciones de la Licencia MIT. Para más detalles, consulte el archivo LICENSE en el repositorio del proyecto.