S3 Tools

Proporciona herramientas para interactuar con buckets de AWS S3.

Documentación

Servidor MCP s3-tools

Un servidor MCP que proporciona herramientas para interactuar con los buckets de AWS S3. Este servidor permite el acceso directo a las operaciones de los buckets de S3 a través del Model Context Protocol.

Características

Herramientas

El servidor actualmente implementa las siguientes herramientas:

list-s3-buckets: Lista todos los buckets de S3 en tu cuenta de AWS
- Parámetro opcional region para especificar la región de AWS
- Devuelve una lista formateada de nombres de buckets

Requisitos previos

Python 3.13 o superior
Credenciales de AWS configuradas (ver Configuración de credenciales de AWS)
Administrador de paquetes uv

Instalación

Desde PyPI

uvx install s3-tools

Desde el código fuente

Clona el repositorio
Instala usando uv:

uv pip install .

Configuración de credenciales de AWS

Este servidor requiere credenciales de AWS para acceder a tus buckets de S3. Puedes configurar las credenciales de varias maneras:

Configuración de AWS CLI (Recomendado)
```
aws configure
```
Esto creará/actualizará las credenciales en ~/.aws/credentials

Variables de entorno

export AWS_ACCESS_KEY_ID="your_access_key"
export AWS_SECRET_ACCESS_KEY="your_secret_key"
export AWS_DEFAULT_REGION="your_preferred_region"  # optional

Rol de IAM (si se ejecuta en infraestructura de AWS)

Para más información sobre las credenciales de AWS, consulta la documentación de AWS.

Configuración

Claude Desktop

Añade la configuración del servidor a tu archivo de configuración de Claude Desktop:

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "s3-tools": {
      "command": "uvx",
      "args": ["s3-tools"]
    }
  }
}

Configuración de desarrollo

Para desarrollo/pruebas, puedes ejecutar el servidor directamente desde el código fuente:

{
  "mcpServers": {
    "s3-tools": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/s3-tools",
        "run",
        "s3-tools"
      ]
    }
  }
}

Desarrollo

Compilación

Sincroniza las dependencias:

uv sync

Compila el paquete:

uv build

Publicación

Para publicar en PyPI:

uv publish

Nota: Necesitarás credenciales de PyPI configuradas mediante:

Token: --token o UV_PUBLISH_TOKEN
O nombre de usuario/contraseña: --username/UV_PUBLISH_USERNAME y --password/UV_PUBLISH_PASSWORD

Depuración

Dado que los servidores MCP se comunican a través de stdio, la depuración puede ser desafiante. Recomendamos usar el MCP Inspector para el desarrollo:

npx @modelcontextprotocol/inspector uv run s3-tools

Licencia

MIT

Contribuciones

¡Las contribuciones son bienvenidas! No dudes en enviar un Pull Request.