Filesystem MCP Server

Example Use Cases

• 1

  Inspect and list directory contents with metadata and optionally traverse recursively through a host filesystem via MCP.

• 2

  Analyze text files for line/word/character counts, detect encoding and mime type, and compute cryptographic hashes for integrity checks.

• 3

  Create or extract ZIP archives and identify duplicate files for cleanup or deduplication workflows.

Description

This repository implements a Model Context Protocol (MCP) server that provides standardized tools for file system access, analysis, and manipulation. It supports directory and file operations (listing, creating, reading, writing, appending), analysis features (text metrics, encoding/mime detection, hashing, duplicate detection), and compression utilities (ZIP creation and extraction). The server leverages common Node.js libraries for encoding detection, hashing, and archive handling and is organized for testability and safe filesystem access. It's useful for agents that need programmatic file inspection, transformation, and archival through an MCP-compliant interface.