Filesystem MCP Server
Serveur MCP de référence pour lire, écrire, chercher et déplacer des fichiers dans des répertoires autorisés.
- Auteur
- Model Context Protocol
- Compatible avec
- Any MCP client
- Licence
- MIT
- Documenté
- Oct 2, 2026
Ce qu'est Filesystem MCP Server
Serveur Node.js implémentant MCP pour les opérations sur le système de fichiers, publié sur npm sous le nom @modelcontextprotocol/server-filesystem. L'accès est limité aux répertoires autorisés, fournis en arguments de ligne de commande ou via MCP Roots.
Ce qu'il fait
- Lit les fichiers texte (avec options head/tail) et les fichiers média
- Lit plusieurs fichiers à la fois
- Écrit et écrase des fichiers
- Crée, liste et supprime des répertoires, et déplace des fichiers ou répertoires
- Recherche des fichiers et obtient leurs métadonnées
- Met à jour les répertoires autorisés à l'exécution via MCP Roots
Quand l'utiliser
Bonne adéquation
- Laisser un agent travailler sur quelques dossiers de projet précis
- Clients qui prennent en charge Roots et ont besoin de changer de répertoires à l'exécution
Pas pour
- Tout ce qui nécessite un accès en dehors des répertoires autorisés
- Une utilisation en production sans votre propre revue : le README racine indique que ce sont des implémentations de référence, conçues comme exemples pédagogiques et non comme solutions prêtes pour la production.
Comment installer Filesystem MCP Server
Il vous faut : Node.js (npx); Au moins un répertoire autorisé via les arguments ou Roots, sinon une erreur survient au démarrage
- Vérifiez que Node.js et npx sont disponibles
- Ajoutez le serveur à la configuration de votre client MCP avec la commande npx
- Passez au moins un répertoire autorisé en argument, ou utilisez un client qui prend en charge Roots
- Redémarrez le client et appelez list_allowed_directories pour confirmer
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/path/to/dir1",
"/path/to/dir2"
]
}
}
}Autorisations et sécurité
Ce à quoi il accède
- Lecture et écriture de fichiers et répertoires dans les répertoires autorisés uniquement
Notes de sécurité des mainteneurs
- write_file écrase les fichiers existants ; le README recommande la prudence
- Le README racine indique que ce sont des implémentations de référence, conçues comme exemples pédagogiques et non comme solutions prêtes pour la production.
Examinez la source avant de donner à un agent l'accès à des identifiants ou à des systèmes de production. Nous documentons ce que déclarent les mainteneurs ; nous n'auditons pas le code.
Limites
- Le serveur renvoie une erreur au démarrage si aucun argument n'est donné et que le client ne prend pas en charge Roots
- Les Roots du client remplacent entièrement les répertoires de la ligne de commande
Questions fréquentes
De quoi le serveur MCP Filesystem a-t-il besoin pour démarrer ?
D'au moins un répertoire autorisé, passé en argument ou fourni par le client via Roots. source
Le serveur MCP Filesystem peut-il accéder à des fichiers hors des répertoires autorisés ?
Non. Le README indique que toutes les opérations sont limitées aux répertoires autorisés. source
Quel est le paquet npm du serveur MCP Filesystem ?
@modelcontextprotocol/server-filesystem. source
Guides associés
Sources et lacunes
- https://raw.githubusercontent.com/modelcontextprotocol/servers/main/src/filesystem/README.md readme, vérifié Oct 2, 2026
- https://raw.githubusercontent.com/modelcontextprotocol/servers/main/README.md readme, vérifié Oct 2, 2026
Non précisé par les mainteneurs : Les hôtes autres que les clients MCP génériques ne sont pas nommés individuellement comme pris en charge (Claude Code/Cursor/Windsurf/Codex) dans ce README; Date de last_release non visible dans le README consulté.