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: AWS S3 Control 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

1. Clonar el repositorio

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

1. Configuración de AWS CLI (recomendada)

   aws configure

   Esto creará/actualizará las credenciales en ~/.aws/credentials

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

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

1. Dependencias de sincronización:

uv sync

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

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.