Filesystem MCP Server (v0.1)

A simple MCP server for filesystem operations with directory sandboxing and read-only mode support.

Early version (0.1) - not thoroughly tested/reviewed, use with caution

Quick Start

Install dependencies:

Run the server:

Related MCP server: MCP File System Server

Features

• Directory sandboxing (operations restricted to allowed paths)

• --read-only flag disables write operations

• Gitignore support for searches

• Human-readable error messages

Usage Examples

Normal Mode

Read-Only Mode

Multiple Directories

Available Tools

Read Operations (always available):

• read_text_file - Read file contents

• list_directory - List directory contents

• directory_tree - JSON directory structure

• search_files - Find files by pattern

• grep - Search text in files

• read_multiple_files - Bulk file reading

Write Operations (disabled in

• create_file - Create new files

• delete_file - Delete files

• move_file - Move/rename files

• edit_file - Edit file contents

• create_directory - Create directories

Dependencies

From pyproject.toml:

• fastmcp>=2.11.2 - MCP framework

• pathspec>=0.12.1 - Gitignore patterns

Security Notes

• All paths resolved with Path.resolve() to prevent traversal

• Operations restricted to allowed directories only

• Binary files rejected for text operations