MCP : Comment Claude interagit intelligemment avec vos fichiers locaux.

Le Model Context Protocol (MCP) fournit un cadre sécurisé permettant aux applications d’interagir avec les systèmes de fichiers via des opérations en bac à sable. Ce guide explique comment fonctionne le MCP, ses principales fonctionnalités, et propose un exemple pratique d’utilisation avec le serveur de système de fichiers MCP.

Qu’est-ce que le Model Context Protocol (MCP) ?

Le Model Context Protocol (MCP) est un puissant cadre de sécurité conçu pour permettre des interactions contrôlées entre applications (comme les assistants IA) et systèmes externes, en particulier les systèmes de fichiers. Faisant office de passerelle sécurisée, MCP permet à des outils d’effectuer des opérations telles que la lecture, l’écriture ou la recherche de fichiers dans un environnement sandboxé et basé sur des permissions.

Le protocole est particulièrement utile pour les développeurs souhaitant intégrer des opérations sur le système de fichiers dans des applications comme VS Code, Claude Desktop ou d’autres environnements de développement, tout en maintenant des frontières de sécurité fortes.

Fonctionnalités clés du MCP

• Opérations sandboxées : Toutes les activités se déroulent dans des répertoires prédéfinis, protégeant les zones sensibles de votre système de fichiers.
• API standardisée : Un ensemble d’outils cohérent (read_file, write_file, etc.) accessible via une interface unifiée.
• Conception axée sécurité : Opérations limitées aux répertoires autorisés avec des options comme le montage en lecture seule.
• Intégration flexible : Compatible avec divers environnements, dont Docker, NPX, VS Code et Claude Desktop.

Explication du serveur de système de fichiers MCP

Le serveur de système de fichiers MCP est une implémentation Node.js spécialement conçue pour les opérations sur le système de fichiers dans le cadre du Model Context Protocol. Il fournit un ensemble complet d’outils pour interagir avec des fichiers et des répertoires de façon contrôlée.

Outils disponibles dans le serveur de fichiers MCP

Voici un aperçu des principales fonctionnalités :

• read_file : Lit le contenu d’un fichier en utilisant l’encodage UTF-8
• read_multiple_files : Traite plusieurs fichiers simultanément, en poursuivant malgré des échecs individuels
• write_file : Crée de nouveaux fichiers ou écrase les fichiers existants
• edit_file : Permet des modifications sélectives avec recherche de motifs, y compris tests à blanc et affichage des différences façon Git
• create_directory : Crée des répertoires avec possibilité de création parentale
• list_directory : Affiche le contenu d’un répertoire avec des préfixes clairs [FILE] ou [DIR]
• move_file : Déplace ou renomme des fichiers et des répertoires
• search_files : Recherche récursive avec prise en charge de motifs d’exclusion
• get_file_info : Récupère des métadonnées telles que taille, date de création et permissions
• list_allowed_directories : Affiche tous les répertoires accessibles pour plus de transparence

Tous ces outils sont accessibles via la ressource file://system, qui sert d’interface pour les opérations sur le système de fichiers MCP.

Utilisation de MCP avec Claude

Pour illustrer le fonctionnement du MCP en pratique, parcourons un exemple réel utilisant le serveur de système de fichiers MCP avec Claude, un assistant IA, pour réaliser des opérations fréquentes sur le système de fichiers.

Étape 1 : Liste des répertoires autorisés

La première étape consistait à déterminer quels répertoires Claude pouvait consulter. Nous avons utilisé l’outil list_allowed_directories, qui a révélé deux emplacements autorisés :

• /Users/arshia/Desktop
• /Users/arshia/Downloads

Cela a confirmé que les opérations de Claude étaient limitées à ces répertoires, protégeant ainsi le reste du système de fichiers.

Étape 2 : Explorer le contenu des répertoires

Ensuite, nous avons utilisé l’outil list_directory pour voir les fichiers disponibles. Les résultats étaient :

Pour /Users/arshia/Desktop :

• [FILE] DS_Store
• [FILE] localized

Pour /Users/arshia/Downloads :

• [FILE] DS_Store
• [FILE] localized
• [DIR] Visual Studio Code.app
• [FILE] shrek.txt
• [FILE] claudes diary.pages
• [FILE] diary.pdf

Cela a révélé un fichier nommé shrek.txt dans le répertoire Downloads, ainsi que d’autres fichiers et un dossier pour Visual Studio Code.

Capture d’écran montrant les requêtes et réponses list_directory pour les répertoires Desktop et Downloads

Étape 3 : Tentative de lecture d’un fichier

Après avoir identifié shrek.txt, nous avons essayé d’en lire le contenu avec l’outil read_file. Initialement, nous avons simplement fourni le nom du fichier shrek.txt, en pensant que l’outil chercherait dans les répertoires autorisés.

Cela a généré une erreur :
« Accès refusé – chemin en dehors des répertoires autorisés : /shrek.txt n’est pas dans /Users/arshia/Desktop, /Users/arshia/Downloads. »
L’erreur s’est produite car MCP exige des chemins de fichiers complets pour des raisons de sécurité.

Image 2 : Capture d’écran de l’échec de read_file avec le message d’erreur

Étape 4 : Lecture réussie du fichier

Après avoir corrigé notre méthode, nous avons fourni le chemin complet /Users/arshia/Downloads/shrek.txt à l’outil read_file. Cette fois, l’opération a réussi et a renvoyé le contenu du fichier :

Request
{
  `path`: `/Users/arshia/Downloads/shrek.txt`
}
Response

Can you see what im writing here? If you do check this out: 

⢀⡴⠑⡄⠀⠀⠀⠀⠀⠀⠀⣀⣀⣤⣤⣤⣀⡀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀ 
⠸⡇⠀⠿⡀⠀⠀⠀⣀⡴⢿⣿⣿⣿⣿⣿⣿⣿⣷⣦⡀⠀⠀⠀⠀⠀⠀⠀⠀⠀ 
⠀⠀⠀⠀⠑⢄⣠⠾⠁⣀⣄⡈⠙⣿⣿⣿⣿⣿⣿⣿⣿⣆⠀⠀⠀⠀⠀⠀⠀⠀ 
⠀⠀⠀⠀⢀⡀⠁⠀⠀⠈⠙⠛⠂⠈⣿⣿⣿⣿⣿⠿⡿⢿⣆⠀⠀⠀⠀⠀⠀⠀ 
⠀⠀⠀⢀⡾⣁⣀⠀⠴⠂⠙⣗⡀⠀⢻⣿⣿⠭⢤⣴⣦⣤⣹⠀⠀⠀⢀⢴⣶⣆ 
⠀⠀⢀⣾⣿⣿⣿⣷⣮⣽⣾⣿⣥⣴⣿⣿⡿⢂⠔⢚⡿⢿⣿⣦⣴⣾⠁⠸⣼⡿ 
⠀⢀⡞⠁⠙⠻⠿⠟⠉⠀⠛⢹⣿⣿⣿⣿⣿⣌⢤⣼⣿⣾⣿⡟⠉⠀⠀⠀⠀⠀ 
⠀⣾⣷⣶⠇⠀⠀⣤⣄⣀⡀⠈⻹⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⡇⠀⠀⠀⠀⠀⠀ 
⠀⠉⠈⠉⠀⠀⢦⡈⢻⣿⣿⣿⣶⣶⣶⣶⣤⣽⡹⣿⣿⣿⣿⡇⠀⠀⠀⠀⠀⠀ 
⠀⠀⠀⠀⠀⠀⠀⠉⠲⣽⡻⢿⣿⣿⣿⣿⣿⣿⣷⣜⣿⣿⣿⡇⠀⠀⠀⠀⠀⠀ 
⠀⠀⠀⠀⠀⠀⠀⢸⣿⣿⣷⣶⣮⣭⣽⣿⣿⣿⣿⣿⣿⣿⠀⠀⠀⠀⠀⠀⠀ 
⠀⠀⠀⠀⠀⣀⣀⣈⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⠇⠀⠀⠀⠀⠀⠀⠀ 
⠀⠀⠀⠀⠀⢿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⠃⠀⠀⠀⠀⠀⠀⠀⠀ 
⠀⠀⠀⠀⠀⠀⠹⣿⣿⣿⣿⣿⣿⣿⣿⣿⡿⠟⠁⠀⠀⠀⠀⠀⠀⠀⠀⠀ 
⠀⠀⠀⠀⠀⠀⠀⠀⠉⠛⠻⠿⠿⠿⠿⠛⠉

Shrek

• Une question demandant si le lecteur voit ce qui est écrit
• Un art ASCII représentant le visage de Shrek
• Le texte « Shrek » à la fin

L’opération réussie a confirmé que MCP pouvait lire des fichiers si le chemin fourni était correct et dans un répertoire autorisé.

Enseignements clés de notre exemple

Ce parcours pratique met en avant plusieurs aspects importants de l’utilisation du MCP :

1. Des chemins complets sont requis : Les outils comme read_file exigent des chemins de fichiers complets, pas seulement les noms.
2. Le sandboxing est efficace : L’échec initial a démontré que le modèle de sécurité de MCP fonctionne comme prévu.
3. L’exploration itérative est la meilleure approche : Utiliser les outils de listing aide à naviguer efficacement dans le système de fichiers.

Bonnes pratiques pour l’implémentation du MCP

D’après notre expérience et les fonctionnalités du serveur de fichiers MCP, nous recommandons les bonnes pratiques suivantes :

• Toujours vérifier les permissions en amont : Utilisez list_allowed_directories avant toute opération.
• Utilisez des chemins complets : Fournissez des chemins absolus pour éviter erreurs et ambiguïtés.
• Testez les modifications en mode test : Avec edit_file, prévisualisez les changements avec dryRun: true avant de les appliquer.
• Prévoyez des succès partiels : Des outils comme read_multiple_files continuent malgré des échecs ponctuels.
• Enforcez le moindre privilège : Lors de la configuration du serveur, montez en lecture seule les répertoires à ne pas modifier.

Conclusion

Le Model Context Protocol (MCP) et son serveur de système de fichiers offrent une approche robuste et sécurisée pour les opérations sur le système de fichiers dans des environnements contrôlés. Notre exemple avec Claude montre une utilisation concrète d’outils comme list_directory et read_file, tout en soulignant l’importance des chemins complets et la compréhension des frontières de permissions.

En suivant les bonnes pratiques présentées ici, vous pourrez exploiter efficacement le MCP pour intégrer en toute sécurité des opérations sur le système de fichiers dans vos applications ou workflows de développement.

Pour les développeurs souhaitant intégrer MCP dans leurs projets, la documentation officielle sur GitHub fournit tous les détails et guides d’implémentation.