Calebmwelsh File System MCP Server

🚀 File System Server

This is a file system management server built on the FastMCP framework. It aims to offer comprehensive file and directory operation functions, including copying, moving, and deleting files, and supports retrieving system information. Currently, it functions most comprehensively on the Windows platform.

🚀 Quick Start

Prerequisites

• Make sure you have Python installed on your system.
• Clone the repository and install the dependencies.

git clone https://github.com/yourusername/file-system-server.git
cd file-system-server
pip install -r requirements.txt

Configuration

Modify the claude_desktop_config.json file according to the example to point to the correct Python interpreter and server file path.

Usage

After completing the above steps, you can start using the server to perform various file and directory operations.

✨ Features

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.
• read_file: Read the content of a file.
• write_file: Write content to a file.
• get_file_info: Get detailed information about a file.
• search_files: Search for files by name.

Directory Operations

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

System Information

• get_system_info: Get basic system information.
• get_disk_info: Query disk usage.

📦 Installation

Clone the Repository

git clone https://github.com/yourusername/file-system-server.git
cd file-system-server

Install Dependencies

pip install -r requirements.txt

💻 Usage Examples

Basic Usage

# Example of getting system information
from fs_server import get_system_info

info = get_system_info()
print(info)

Advanced Usage

# Example of recursively listing a directory
from fs_server import list_directory_recursively

directory_path = '.'
result = list_directory_recursively(directory_path)
for item in result:
    print(item)

📚 Documentation

Project Structure

file-system-server/
├── fs_server.py                  # Main implementation of the file system service
├── windows_utils.py             # Windows platform-specific functional module
├── requirements.txt              # List of dependencies
└── claude_desktop_config.json   # Example of Claude desktop configuration

Platform Support

• Windows: Full functionality support, including drive listing, special folder access, and system information.
• macOS/Linux: Only basic functions such as file operations and directory management are supported.

Configuration Guide

1. Clone the repository as described in the installation section.
2. Install the dependencies.
3. Configure the Claude desktop settings by modifying the claude_desktop_config.json file according to the example.

🔧 Technical Details

Path Validation

All file operations include path validation to ensure the security of operations.

Backup Mechanism

Destructive operations create backup files to prevent data loss.

Access Control

Access to system information is strictly restricted to protect system security.

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.

⚠️ Known Issues

• File Deletion: The file deletion function may fail to delete certain files correctly. Manual verification is recommended.
• Drive Listing: The drive listing function may not detect all available drives or display error messages.

💡 Usage Tip

• When performing important operations, it is recommended to create backups in advance to avoid data loss.
• If you encounter any issues, please refer to the known issues section or submit an issue on GitHub.