convez.ai
MCP ServerIntegração & APIsIntermediário
ofershap

MCP Server S3

ofershap/mcp-server-s3

Gerenciamento de S3 integrado ao Claude — liste, upload, download e URLs

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP para gerenciar buckets e objetos do AWS S3 diretamente do Claude, Cursor e outros clientes MCP. Permite listar buckets, navegar arquivos, fazer upload/download e gerar URLs pressinadas sem sair da IA.

Instalação

$npx convez-ai ofershap/mcp-server-s3

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
4
Forks
1
Acompanhando
0
Saúde
42%
Último commit
há 3 meses
Versão
—
Issues abertas
2
Contribuidores
2

Casos de uso

  • Navegar e gerenciar arquivos em S3 via assistente de IA
  • Gerar URLs pressinadas temporárias para compartilhamento seguro
  • Automatizar upload/download de conteúdo em pipelines de IA
  • Verificar e explorar buckets sem usar CLI do AWS

Veredito

MCP server robusto e bem mantido que colma uma lacuna real: S3 é onipresente mas não tinha uma integração MCP polida no npm. Implementação clara em TypeScript com suporte a credenciais AWS padrão. Ideal para fluxos de IA que precisam manipular arquivos em nuvem nativamente.

README

A tradução para o português deste README ainda está na fila.

mcp-server-s3

npm version npm downloads CI TypeScript License: MIT

Manage AWS S3 buckets and objects from your AI assistant. Browse files, upload and download content, and generate presigned URLs.

npx mcp-server-s3

Works with Claude Desktop, Cursor, VS Code Copilot, and any MCP client. Uses your existing AWS credentials (~/.aws/credentials or environment variables).

MCP server for AWS S3 bucket management and file operations

Demo built with remotion-readme-kit

Why

S3 is the most widely used cloud storage service, but managing it from the command line means remembering aws s3 ls, aws s3 cp, presigned URL syntax, and various flags. Google has an official MCP for GCS, Cloudflare has one for R2, but AWS S3 doesn't have a polished standalone MCP server on npm. This one lets you ask your assistant to list buckets, download a config file, upload content, or generate a temporary sharing link. It uses the standard AWS credential chain, so if your CLI already works, this works too.

Tools

ToolWhat it does
list_bucketsList all S3 buckets in your AWS account.
list_objectsList objects in a bucket, with optional prefix filter.
get_objectDownload and read an object's content as text.
put_objectUpload text content to an S3 object.
delete_objectDelete an object from a bucket.
presigned_urlGenerate a temporary presigned URL for an object.
bucket_infoCheck if a bucket exists and get basic info.

Quick Start

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "s3": {
      "command": "npx",
      "args": ["mcp-server-s3"],
      "env": {
        "AWS_REGION": "us-east-1",
        "AWS_ACCESS_KEY_ID": "your-access-key",
        "AWS_SECRET_ACCESS_KEY": "your-secret-key"
      }
    }
  }
}

Claude Desktop

Add to claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "s3": {
      "command": "npx",
      "args": ["mcp-server-s3"],
      "env": {
        "AWS_REGION": "us-east-1",
        "AWS_ACCESS_KEY_ID": "your-access-key",
        "AWS_SECRET_ACCESS_KEY": "your-secret-key"
      }
    }
  }
}

VS Code

Configure the MCP server to run npx mcp-server-s3 with AWS_REGION, AWS_ACCESS_KEY_ID, and AWS_SECRET_ACCESS_KEY in the environment.

Authentication

The server uses the standard AWS credential chain:

  1. Environment variables: AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_REGION
  2. Shared credentials file: ~/.aws/credentials
  3. IAM roles: when running on EC2, ECS, Lambda, or similar

Set AWS_REGION (defaults to us-east-1) and make sure your credentials have the necessary S3 permissions: s3:ListBuckets, s3:ListBucket, s3:GetObject, s3:PutObject, s3:DeleteObject, s3:HeadBucket.

Example prompts

  • "List all my S3 buckets"
  • "Show me the files in my-bucket/uploads/"
  • "Download the config.json from my-bucket"
  • "Upload this content to my-bucket/notes.txt"
  • "Generate a presigned URL for this file that expires in 1 hour"

Development

npm install
npm run typecheck
npm run build
npm test
npm run format
npm run lint

See also

More MCP servers and developer tools on my portfolio.

Author

Made by ofershap

LinkedIn GitHub


README built with README Builder

License

MIT © 2026 Ofer Shapira

Ver o original no GitHub

Bom para