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

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
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
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
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.