File System MCP Server

Name: File System MCP Server
Author: calebmwelsh

@calebmwelsh

About File System MCP Server

A comprehensive MCP (Model Context Protocol) server for file system operations, providing Claude and other AI assistants with access to local files and directories.

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "file-system-mcp-server": {
      "command": "python",
      "args": [
        "-m",
        "venv",
        "venv"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is File System MCP Server?

A file system management server built with FastMCP that provides a comprehensive set of tools for file and directory operations. It allows performing various file system operations through a structured API, making it ideal for automation and integration with other systems.

How to use File System MCP Server?

Clone the repository, create and activate a virtual environment, install dependencies with pip install -r requirements.txt, then configure the server in your MCP client (e.g., Claude) by adding the server's command and path to claude_desktop_config.json. After configuration, restart the client and use the provided tools by asking the AI to perform file operations.

Key features of File System MCP Server

Copy, move, delete files with backup and safety checks
Read, write, and search files by name pattern
List, create, delete directories, including recursive tree views
Get file information, directory statistics, disk usage, and system info
Create file collections with optional custom storage path
Windows full support; macOS/Linux support for basic operations

Use cases of File System MCP Server

Automate file organization and backup tasks via an MCP client
Integrate file system operations into AI-driven workflows
Manage remote file systems through a structured API
Perform bulk file operations with safety checks and error handling

FAQ from File System MCP Server

What operating systems does File System MCP Server support?

Windows has full feature support including drive listing and special folders. macOS and Linux support basic file/directory operations, file search, and metadata, but some Windows-specific features are unavailable.

What dependencies are required?

Required dependencies: FastMCP, Pydantic. On Windows, pywin32 and WMI are also needed. Install all with pip install -r requirements.txt.

How do I find the Python path for configuration?

On Windows PowerShell: (Get-Command python).Source. On Windows CMD: where python. On Linux/macOS: which python. Use the returned path in your MCP configuration.

Are there any known issues?

Yes. The delete_file function may fail to properly delete files. The list_drives function may not correctly detect all drives. Both issues are under investigation.

How are file collections stored?

Collections can be stored in any user-specified directory. If no storage path is given, they are stored in a default location inside the project's data/collections directory.