s3-tools

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

  • Provides tools for interacting with AWS S3 buckets, allowing users to list all S3 buckets in their AWS account with optional region specification.

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

Prerrequisitos

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

You must be authenticated.

A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

Un servidor MCP que proporciona herramientas para interactuar con los buckets de AWS S3, lo que permite el acceso directo a las operaciones de S3 a través del Protocolo de contexto de modelo.

  1. Features
    1. Tools
  2. Prerequisites
    1. Installation
      1. From PyPI
      2. From Source
    2. AWS Credentials Setup
      1. Configuration
        1. Claude Desktop
        2. Development Configuration
      2. Development
        1. Building
        2. Publishing
        3. Debugging
      3. License
        1. Contributing
          ID: gwm71t70bc