FTP Manager

🚀 File Manager MCP 📂

A powerful and user-friendly file manager application that offers a modern interface for managing FTP file operations.

🤖 AI-Powered Development: This project is the result of AI prompt engineering. The entire codebase was developed in collaboration with AI, demonstrating the potential of modern AI-assisted development practices.

🚀 Quick Start

Using the smithery Hosting Service (Recommended)

1. Visit File Manager on smithery

2. Create an account or log in

3. Connect using your preferred development environment:

   • Visual Studio Code
   • Cursor
   • Any IDE or tool with MCP integration

Alternative: Local Installation

If you prefer to run the application locally, follow these steps:

1. Ensure you have installed the .NET 9.0 SDK

2. Build and run the application as described below

🛠️ Building and Running Locally

1. Clone the repository:

   HTTPS:

   git clone https://github.com/taha-ghadirian/FileManagerMcp.git
   

   SSH:

   git clone git@github.com:taha-ghadirian/FileManagerMcp.git
   

   Then navigate to the project directory:

   cd FileManagerMcp
   

2. Install dependencies:

dotnet restore

3. Build the project:

dotnet build

4. Run the application using the inspector:

npx @modelcontextprotocol/inspector dotnet run

✨ Features

• 📁 Check and manage remote FTP directories
• ⬆️ Upload files and directories
• ⬇️ Download files and directories
• 🗑️ Delete files and directories
• 📝 Create new directories
• 🔄 Support for recursive file operations
• 💻 Clean and intuitive user interface

🔧 Configuration

The application uses environment variables for configuration. Here are the required environment variables:

You can set these environment variables in multiple ways:

1. Set them inline when running the application:

   ftpHost=ftp.example.com ftpUsername=myuser ftpPassword=mypassword npx @modelcontextprotocol/inspector dotnet run
   

⚠️ Important Note

Do not commit sensitive information such as passwords to version control. Always use environment variables or secure secret management for production deployments.

🤝 Contribution

Contributions are welcome! Feel free to submit a Pull Request.

1. When submitting code, ensure you follow the standard Git workflow.
2. Provide clear descriptions of your changes and refer to How to Write a Good Commit Message.
3. If you reference any resources or dependencies in the project, indicate them in package.json or other appropriate files.

📄 License

This project is licensed under the GPL-3.0 license. Please ensure you comply with the license terms when redistributing or modifying the project.

💡 Contact

If you have any questions or feedback, please contact us via:

• Email: contact@yourdomain.com
• GitHub: @yourusername

Thank you for your support of the project!