list_directoryLABSCO SUMMARY
More than read and write.
Most filesystem servers stop at reading and writing a file. This one adds the operations you would otherwise shell out for — hashing, duplicate detection, text analysis and zip handling — so a cleanup task stays inside one tool set.
What it is
A filesystem server that goes past read and write. Alongside directory and file operations it exposes text analysis, hashing, duplicate detection and archive handling through the same tool interface.
What you get
- Directory listings with metadata — size, mode, created, modified and accessed times — optionally recursive
- Directories created, with parent directories made for you
- Files read, written and appended to, with the encoding under your control
- Text analysed rather than simply returned
- A hash calculated over a file, for comparison or integrity
- Duplicate files found across a set
- Zip archives created and extracted
Requirements
Node with npm install and npm run build, then one stdio entry pointing at the built index.js. It reads and writes the local filesystem, so the paths you expose to it are exactly the scope you have granted.
Setup effort
Build from source — git clone https://github.com/bsmi021/mcp-filesystem-server.git
USE CASES
Clearing out a directory that has grown copies
Find the duplicates, confirm them by hash, then act — rather than trusting what the filenames suggest.
Reading and editing a file in place
Read with the encoding you need, then write or append back the same way.
Packaging output for delivery
Build the directory, write the files into it, zip the result.
Opening an archive someone sent you
Extract it, then list what came out with its metadata before trusting any of it.
Getting a read on a text file before processing it
Analysis rather than a raw dump, for the files that are bigger than the question you have about them.
10 tools
Listed in project docs. Your client may show a different list.
create_directoryread_filewrite_fileappend_fileanalyze_textcalculate_hashfind_duplicatescreate_zipextract_zipBEFORE YOU INSTALL
What to know first
Tools you get
10 tools named in the project's documentation.
Requires
node on PATH
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
You clone and build this one yourself.
Server setup
git clone https://github.com/bsmi021/mcp-filesystem-server.git
cd mcp-filesystem-server
npm install
npm run buildMCP Clients
Cline
{
"mcpServers": {
"filesystem": {
"command": "node",
"args": [
"<YOUR_PATH_TO_MCP_FILESYSTEM_SERVER>/build/index.js"
]
}
}
}