Zo werkt de Filesystem MCP-referentieserver: de 13 tools, toegestane mappen, Roots, alleen-lezen Docker-mounts en een builder die de config-JSON voor u schrijft.
De Filesystem MCP-server is het Node.js-referentieprogramma van het Model Context Protocol-project waarmee een AI-assistent bestanden kan lezen, schrijven, doorzoeken en verplaatsen, maar alleen binnen mappen die u toestaat. U geeft die mappen op bij het starten, of uw app levert ze aan via Roots. Alles daarbuiten wordt geweigerd.
De Filesystem MCP-server in één oogopslag
Onderdeel
Waarde
npm-pakket
@modelcontextprotocol/server-filesystem
Docker-image
mcp/filesystem
Waar het draait
Op uw eigen computer, gestart door uw MCP-app
Toegangsgrens
Alleen toegestane mappen, via argumenten of Roots
Tools
13, waarvan 9 alleen lezen
MCP (Model Context Protocol) is een open standaard waarmee een assistent-app kleine hulpprogramma's kan aanroepen, servers genoemd. De filesystem-server is meestal de eerste die mensen installeren, omdat hij "kijk eens in mijn map met productbeschrijvingen" verandert in iets wat de assistent echt kan doen. Deze pagina legt uit waar hij bij kan, hoe de mapgrens werkt en hoe u hem alleen-lezen houdt. Gebruik de builder hieronder om een config te maken die u in de MCP-instellingen van uw app kunt plakken.
Typ de mappen die de assistent mag zien, één per regel, met volledige paden.
Kies npx (vereist Node.js) of Docker. Docker kan mappen alleen-lezen mounten.
Kies de configvorm die uw app verwacht: de meeste apps gebruiken mcpServers, VS Code gebruikt servers.
Kopieer de JSON naar het MCP-configbestand van uw app en herstart de app zodat die de server start.
Deel de kleinste map die volstaat, zoals één contentmap, nooit uw hele thuismap.
Draai hem via Docker met alleen-lezen mounts als de assistent alleen hoeft te lezen.
Vraag de assistent eerst list_allowed_directories uit te voeren, zodat u precies ziet wat hij heeft gekregen.
Gebruik de dry run-optie van edit_file voordat u wijzigingen laat doorvoeren in bestanden die belangrijk voor u zijn.
Bewaar een back-up of versiegeschiedenis van alles waarnaar u de assistent laat schrijven.
Veelgestelde vragen
Kan de filesystem MCP-server bestanden lezen buiten de mappen die ik opgeef?
Nee. De README stelt dat alle bestandssysteembewerkingen beperkt zijn tot toegestane mappen. Als de client Roots stuurt, vervangen die de mappen uit de opdrachtregel volledig, dus de toegestane lijst is wat uw app het laatst heeft aangeleverd.
Wat gebeurt er als ik hem start zonder mappen?
Als uw app Roots ondersteunt, wacht de server tot de app ze stuurt. Ondersteunt de app geen Roots en hebt u geen mappen opgegeven, dan logt de server de reden, sluit de verbinding en stopt met status 1.
Hoe maak ik hem alleen-lezen?
De README beschrijft één manier: draai de Docker-image en voeg ro toe aan elke bind mount, waardoor die map readonly is voor de server. Sommige apps laten u ook afzonderlijke tools goedkeuren of blokkeren, wat helpt, maar de mount is de stevigere grens.
Kan hij bestanden verwijderen?
Zijn toollijst bevat geen verwijdertool. Toch kan hij inhoud vernietigen: write_file overschrijft bestaande bestanden en move_file haalt de bron weg, dus beide staan als destructief gemarkeerd in de annotatietabel van de README.
Heeft hij internettoegang nodig?
Niet voor zijn werk. Elke tool zet openWorldHint op false, wat betekent dat hij alleen het lokale bestandssysteem binnen toegestane mappen aanraakt. npx downloadt het pakket wel de eerste keer dat het draait.
Toegestane mappen en Roots, in gewone taal
Er zijn twee manieren om de server te vertellen welke mappen hij mag gebruiken. De eerste is mappaden achter de pakketnaam in de config zetten, waarmee de lijst vastligt tot u herstart. De tweede is Roots, een functie waarbij de assistent-app de server vertelt welke mappen meedoen en die lijst tijdens het draaien kan wijzigen.
De README noemt Roots de aanbevolen methode. Het detail dat voor veiligheid telt: zodra de Roots van uw app actief zijn, trekt een update zonder geldige roots alle toegang in, in plaats van terug te vallen op de mappen die u hebt getypt.
Nuttige taken voor een site- of webwinkeleigenaar
Wijs hem een map met geëxporteerde productgegevens aan en vraag om een lijst van artikelen zonder beschrijving. Wijs hem uw blogconcepten aan en vraag om een overzicht van welke berichten een oude prijs noemen. Wijs hem een gedownloade kopie van uw site aan en zoek naar kapotte afbeeldingsnamen.
In elk geval is de map een kopie, niet de live site, dus een verkeerde bewerking kost niets. Die gewoonte is meer waard dan welke instelling ook.
De 13 tools en wat elk kan wijzigen
Alleen-lezen betekent dat de README de tool markeert met readOnlyHint true. Destructief betekent dat hij bestaande inhoud kan overschrijven of verwijderen.
Tools van de Filesystem MCP-server
Tool
Wat hij doet
Wijzigt bestanden?
Leest een bestand als UTF-8-tekst, optioneel alleen de eerste of laatste N regels
Nee
Leest een afbeelding, audio of ander bestand als base64 met het MIME-type
Nee
Leest meerdere bestanden tegelijk; één fout stopt de rest niet
Nee
Toont de inhoud van een map met de voorvoegsels [FILE] en [DIR]
Nee
Dezelfde lijst met groottes, te sorteren op naam of grootte
Nee
Geeft een geneste JSON-boom van een map terug
Nee
Zoeken in glob-stijl met optionele uitsluitpatronen
Nee
Grootte, tijden, type en rechten
Nee
Toont welke mappen de server mag gebruiken
Nee
Maakt een map aan plus eventuele ontbrekende bovenliggende mappen
Ja, niet destructief
Maakt een bestand aan of overschrijft het
Ja, destructief
Vervangt gevonden tekst, met een dryRun-voorbeeldoptie
Ja, destructief
Verplaatst of hernoemt; mislukt als de bestemming al bestaat
Ja, destructief
Configvoorbeelden
Draaien met npx, twee mappen
De mappen na de pakketnaam worden de toegestane mappen. Vereist Node.js op uw computer.
Draaien met Docker, één map alleen-lezen
Mappen worden gemount onder /projects. De ro-vlag voorkomt dat de server naar die map schrijft.
VS Code-werkruimteconfig (.vscode/mcp.json)
VS Code gebruikt een servers-sleutel. ${workspaceFolder} beperkt de server tot het project dat u open hebt.
Configbuilder voor de Filesystem MCP-server
Typ uw mappen en kies hoe de server draait. De JSON wordt bijgewerkt terwijl u typt en niets verlaat uw browser.
Toegestane mappen, één volledig pad per regel
Draaien met
Configvorm
Mappen alleen-lezen mounten (alleen Docker)
Alleen-lezen mounten is gedocumenteerd voor Docker. Met npx kan de server schrijven in de mappen die u opgeeft.
Config-JSON
npx (Node.js)
Docker
mcpServers (de meeste apps)
servers (VS Code)
Voeg minstens één map toe. De server heeft één toegestane map nodig om te werken.
{v} is geen volledig pad. Begin met / op Mac of Linux, of met een stationsletter op Windows.