Servidor MCP de 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 mediante el Protocolo de Contexto de Modelo.

Características

Herramientas

El servidor actualmente implementa las siguientes herramientas:

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

Related MCP server: MCP Server

Prerrequisitos

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

Instalación

Desde PyPI

uvx install s3-tools

De la fuente

Clonar el repositorio
Instalar usando uv:

uv pip install .

Configuración de credenciales de AWS

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

Configuración de AWS CLI (recomendada)
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 la infraestructura de AWS)

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

Configuración

Escritorio de Claude

Agregue la configuración del servidor a su archivo de configuración de Claude Desktop:

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

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

Configuración de desarrollo

Para desarrollo/prueba, puede ejecutar el servidor directamente desde la fuente:

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

Desarrollo

Edificio

Dependencias de sincronización:

uv sync

Paquete de compilación:

uv build

Publicación

Para publicar en PyPI:

uv publish

Nota: Necesitará credenciales de PyPI configuradas a través de:

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 complicada. Recomendamos usar el Inspector MCP para el desarrollo:

npx @modelcontextprotocol/inspector uv run s3-tools