File System MCP Server

What is File System MCP Server?

It's a file system management server built with FastMCP that provides a comprehensive set of tools for file and directory operations. Designed for integration with AI assistants like Claude, it enables automated file management through a structured API.

How to use File System MCP Server?

Clone the repository, create a virtual environment, and install dependencies with pip install -r requirements.txt. For Claude integration, add the server to claude_desktop_config.json using the absolute paths to your Python executable and the fs_server.py script.

Key features of File System MCP Server

• Copy, move, delete files with backup support
• Read, write, and search file contents
• Create and manage file collections
• List, create, and delete directories recursively
• Retrieve system and disk information
• Full Windows support; basic macOS/Linux support

Use cases of File System MCP Server

• Automating file management tasks through AI assistant prompts
• Organizing related files into collections for easy access
• Monitoring system resources (disk usage, memory, CPU)
• Performing safe file operations with automatic backups
• Cross-platform file operations (with platform-specific limitations)

FAQ from File System MCP Server

What are the required dependencies?

FastMCP, Pydantic, and platform-specific libraries: pywin32 and WMI on Windows only.

How do I integrate this server with Claude?

Add a entry to claude_desktop_config.json with the command pointing to your Python executable and args containing the path to fs_server.py. Example for Windows: "command": "C:\\Users\\YourUsername\\...\\python.exe", "args": ["C:\\Users\\...\\fs_server.py"].

What are the known issues?

The delete_file function may fail in some cases, and list_drives may not detect all drives correctly. Windows-specific features are unavailable on macOS/Linux.

Where are file collections stored?

Collections are stored in a user-specified directory. If no location is given, they default to data/collections within the project folder.

Does File System MCP Server work on macOS and Linux?

Yes, basic file and directory operations are supported. Windows-specific features (drive listing, special folders, detailed system info) are not available on macOS/Linux.