S3 Tools

Fornece ferramentas para interagir com buckets AWS S3.

Documentação

Servidor MCP s3-tools

Um servidor MCP que fornece ferramentas para interagir com buckets do AWS S3. Este servidor permite acesso direto às operações de buckets S3 através do Model Context Protocol.

Recursos

Ferramentas

O servidor atualmente implementa as seguintes ferramentas:

list-s3-buckets: Lista todos os buckets S3 na sua conta AWS
- Parâmetro opcional region para especificar a região AWS
- Retorna uma lista formatada de nomes de buckets

Pré-requisitos

Python 3.13 ou superior
Credenciais AWS configuradas (veja Configuração de Credenciais AWS)
Gerenciador de pacotes uv

Instalação

Via PyPI

uvx install s3-tools

Via Código Fonte

Clone o repositório
Instale usando uv:

uv pip install .

Configuração de Credenciais AWS

Este servidor requer credenciais AWS para acessar seus buckets S3. Você pode configurar as credenciais de várias maneiras:

Configuração da AWS CLI (Recomendado)
```
aws configure
```
Isso criará/atualizará as credenciais em ~/.aws/credentials

Variáveis de Ambiente

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

Perfil IAM (se estiver executando em infraestrutura AWS)

Para mais informações sobre credenciais AWS, consulte a documentação da AWS.

Configuração

Claude Desktop

Adicione a configuração do servidor ao arquivo de configuração do 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"]
    }
  }
}

Configuração de Desenvolvimento

Para desenvolvimento/testes, você pode executar o servidor diretamente do código fonte:

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

Desenvolvimento

Compilação

Sincronize as dependências:

uv sync

Compile o pacote:

uv build

Publicação

Para publicar no PyPI:

uv publish

Nota: Você precisará de credenciais PyPI configuradas via:

Token: --token ou UV_PUBLISH_TOKEN
Ou usuário/senha: --username/UV_PUBLISH_USERNAME e --password/UV_PUBLISH_PASSWORD

Depuração

Como os servidores MCP se comunicam via stdio, a depuração pode ser desafiadora. Recomendamos usar o MCP Inspector para desenvolvimento:

npx @modelcontextprotocol/inspector uv run s3-tools

Licença

MIT

Contribuição

Contribuições são bem-vindas! Sinta-se à vontade para enviar um Pull Request.