File System MCP Server

🚀 File System MCP Server

The File System MCP Server is a modern file management system built on FastMCP. It offers a wide range of file and directory operation functions, including file copying, moving, deletion, content reading and writing. Additionally, the server supports functions such as obtaining file information, searching for files, creating and deleting directories, and listing directory contents. The system information section can also provide details about computer hardware, storage devices, and directory statistics.

🚀 Quick Start

Platform Support

Windows

• Supports all Windows operating system versions.
• Provides full file and directory operation functions.
• Supports drive list display and path handling.

macOS/Linux

• Supports macOS and Linux systems.
• Provides basic file and directory operation functions.
• Some platform - related functions may be limited.

Future Plans

Feature Development Roadmap

1. Phase 1: Basic Cross - platform Compatibility Improvement

   • Improve file path handling logic.
   • Enhance the security and accuracy of system information retrieval.
   • Fix known issues, such as file deletion failures and incomplete drive lists.

2. Phase 2: Enhanced Feature Development

   • Implement a unified error handling mechanism across platforms.
   • Add path validation for more file operations.
   • Develop new system information retrieval interfaces.

3. Phase 3: Extended Feature Implementation

   • Introduce drive mapping and network sharing support (for Windows).
   • Enhance the directory tree structure display function.
   • Implement more advanced file search algorithms.

✨ Features

Project Structure

- README.md: Project introduction and usage instructions
- LICENSE: MIT License
- requirements.txt: List of Python dependencies
- fs_server.py: Main server file
- schemas: Pydantic data validation models
- tools: Function implementation tool modules

Dependencies

Install Python Packages

pip install -r requirements.txt

Setup

1. Configure Claude
   • Edit the claude_desktop_config.json file.
   • Add the following content:

     {
       "file_system_tools": {
         "command": "/usr/bin/python3",
         "args": [
           "/path/to/fs_server.py"
         ]
       }
     }
     

   • Save the file and restart Claude.

Usage Examples

File Operations

• copy_file: Copy a file, with an option to create a backup.
• move_file: Move a file, with an option to create a backup.
• delete_file: Securely delete a file (with a confirmation mechanism).
• read_file: Read file content and return a string.
• write_file: Write content to a file.
• get_file_info: Get detailed file information.
• search_files: Search for files by name.
• create_collection: Create a file collection.

Directory Operations

• list_directory: List directory contents.
• create_directory: Create a new directory.
• delete_directory: Delete a directory.
• list_directory_recursively: Display the directory structure in a tree format.
• search_directories: Search for directories by name.

System Information

• get_system_info: Get system hardware and software information.
• get_disk_info: Get disk usage information.
• get_directory_info: Get directory statistics.

Known Issues

1. File Deletion Function

   • The delete_file function may not work properly in some cases. It is recommended to manually verify or use other methods for deletion.

2. Drive List Function

   • The list_drives function may not correctly detect all available drives. Some drives may be missing or display error messages.

3. Platform Limitations

   • Windows - specific functions are not available on macOS/Linux.
   • There may be differences in path handling and system information retrieval between different platforms.

Error Handling

• All file and directory operations have detailed error capture and logging mechanisms.
• A unified exception handling interface is provided to ensure that users can accurately obtain error information.

Security

• Path validation is enabled by default for file operations to prevent malicious path injection attacks.
• System information retrieval has undergone strict security reviews to ensure that no sensitive information is leaked.

📄 License

This project is licensed under the MIT License. Please comply with the relevant terms when using and distributing it.