MCP File System Server

Example Use Cases

• 1

  Read and inspect project source files and documentation within a constrained, secure project directory.

• 2

  Create, overwrite, append, or make precise exact-match edits to files and preview changes with unified diffs.

• 3

  Reference additional codebases or docs in read-only mode while keeping write access restricted to the main project.

Description

This open-source MCP server provides a clean API for performing file system operations inside a specified project directory, enabling AI assistants to read, write, edit, move, and delete files securely. It includes specialized tools (list_directory, read_file, save_file, edit_file with exact-match diffs, move_file, etc.) and supports read-only reference projects for contextual browsing. The server emphasizes security (path normalization, gitignore filtering, atomic writes) and includes structured human-readable and JSON logging. It is designed for integration with MCP-compatible clients such as the Claude Desktop app.