Filesystem MCP Server

Example Use Cases

• 1

  Read, write, or preview edits to project files within sandboxed directories while preserving indentation and producing git-style diffs.

• 2

  Search and index repository or project files recursively, with support for exclude patterns and case-insensitive matching.

• 3

  Manage filesystem structure—create/list/delete directories, move/rename files—and retrieve file metadata in a controlled environment.

Description

This server implements the Model Context Protocol (MCP) to let agents perform common filesystem tasks—reading and writing files, creating and listing directories, moving items, searching, and retrieving file metadata—while restricting access to explicitly allowed directories. It includes an advanced edit_file tool with dry-run previews, indentation detection, and git-style diffs to safely preview and apply changes. The server is distributable via Docker or NPX and is licensed under the MIT License. It is intended to be mounted or pointed at specific sandboxed directories so agents cannot access the broader host filesystem.