Serveur MCP AWS S3

Serveur MCP pour les opérations AWS S3, fournissant un accès sécurisé aux buckets S3 par le biais d'URL pré-signées.

Outils

1. list_objects

   • Liste les objets d'un panier S3
   • Entrée
     • prefix (chaîne, facultatif) : Filtre de préfixe pour les clés d'objets
   • Retourne : Tableau d'objets avec les clés, les tailles et les dates de dernière modification

2. get_object

   • Génère une URL pré-signée pour accéder à un objet
   • Entrées
     • key (chaîne, obligatoire) : Clé de l'objet à récupérer
     • expiry (nombre, optionnel) : Délai d'expiration de l'URL en secondes (par défaut : 3600)
   • Retourne : object_url contenant l'URL pré-signée

3. put_object

   • Générer une URL pré-signée pour le téléchargement d'un objet
   • Entrées
     • key (chaîne, obligatoire) : Clé de l'objet à télécharger
     • expiry (nombre, optionnel) : Délai d'expiration de l'URL en secondes (par défaut : 3600)
   • Returns : upload_url contenant l'URL pré-signée

4. delete_object

   • Supprime un objet du seau
   • Entrée
     • key (chaîne, obligatoire) : Clé de l'objet à supprimer
   • Returns : success booléen indiquant le statut de la suppression

Configuration

Variables d'environnement

Le serveur a besoin des variables d'environnement suivantes :

• BUCKET_NAME: Le nom de votre bucket S3 (obligatoire)
• REGION: Région AWS (par défaut : "ap-southeast-1")

Les informations d'identification AWS doivent être configurées en utilisant les méthodes standard de configuration des informations d'identification AWS (variables d'environnement, rôles IAM, ou fichier d'informations d'identification AWS).

Utilisation avec Claude Desktop

Ajoutez les éléments suivants à votre fichier claude_desktop_config.json:

{ "mcpServers" : { "aws-ow-s3-mcp" : { "command" : "docker", "args" : [ "run", "-i", "--rm", "-e", "BUCKET_NAME", "-e", "REGION", "-e", "AWS_ACCESS_KEY_ID", "-e", "AWS_SECRET_ACCESS_KEY", "mcp/aws-ow-s3-mcp" ], "env" : { "BUCKET_NAME" : "<VOTRE_NOM_DE_BUCKET>", "REGION" : "<AWS_REGION>", "AWS_ACCESS_KEY_ID" : "<VOTRE_CLÉ_D'ACCÈS>", "AWS_SECRET_ACCESS_KEY" : "<VOTRE_CLÉ_SECRÈTE>" } } }

Commande NPX

{ "mcpServers" : { "aws-ow-s3-mcp" : { "command" : "npx", "args" : [ "-y", "@modelcontextprotocol/server-aws-ow-s3-mcp" ], "env" : { "BUCKET_NAME" : "<VOTRE_NOM_DE_BUCKET>", "REGION" : "<AWS_REGION>", "AWS_ACCESS_KEY_ID" : "<VOTRE_CLÉ_D'ACCÈS>", "AWS_SECRET_ACCESS_KEY" : "<VOTRE_CLÉ_SECRÈTE>" } } } }

Construction

Construction de Docker :

docker build -t mcp/aws-ow-s3-mcp-server

Développement

Le serveur est construit en utilisant :

• Node.js
• TypeScript
• @modelcontextprotocol/sdk
• @aws-sdk/client-s3
• @aws-sdk/s3-request-presigner

Licence

Ce serveur MCP est sous licence MIT. Cela signifie que vous êtes libre d'utiliser, de modifier et de distribuer le logiciel, sous réserve des termes et conditions de la licence MIT. Pour plus de détails, veuillez consulter le fichier LICENSE dans le référentiel du projet.