Filesystem MCP Server

Example Use Cases

• 1

  Read, preview, and edit source files safely within a sandboxed set of allowed directories (use dryRun to preview edits).

• 2

  Search and discover files or directories recursively and return full paths and metadata for downstream processing.

• 3

  Perform filesystem maintenance tasks such as creating directories, moving or renaming files, and listing directory contents programmatically.

Description

This server implements the Model Context Protocol (MCP) to let agents perform file and directory operations programmatically. It provides read/write/edit tools, directory management, recursive search, move/rename, and detailed file metadata, with safety enforced by a list of allowed directories. The server supports Docker and npx deployments and includes features like dry-run previews and git-style diffs for edits to reduce risk. It's designed to let agents interact with host filesystems in a sandboxed, auditable way.