@gdm-pixel/ftp-uploads-mcp

🔐 Subscription-Based FTP Uploads MCP

FTP uploads with automatic image optimization.

⚠️ Requires Nova-Mind Cloud subscription - Starting at €39/month

💎 Open Source Code + Cloud Services

✅ Code is open - Audit, learn, modify freely
🔐 Usage requires subscription - Backend authentication & infrastructure

👉 View pricing | Plans: €39 / €89 / €149 per month

✨ Features

• 📤 Direct FTP Upload - Upload images to your FTP server
• 🖼️ Auto Optimization - Automatic WebP conversion + JPEG optimization
• 📏 Smart Resizing - Intelligent image resizing for web performance
• 🔗 Public URLs - Instant public URLs after upload
• 🎨 Multi-format - Supports JPEG, PNG, WebP, GIF
• ⚡ Fast & Efficient - Sharp-based image processing

📦 Installation

With Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "ftp-uploads": {
      "command": "npx",
      "args": ["-y", "@gdm-pixel/ftp-uploads-mcp@latest"],
      "env": {
        "FTP_HOST": "ftp.your-server.com",
        "FTP_USER": "your-username",
        "FTP_PASSWORD": "your-password",
        "FTP_PORT": "21",
        "FTP_TARGET_DIR": "/public/images/",
        "FTP_PUBLIC_URL": "https://your-domain.com/images/"
      }
    }
  }
}

Config location:

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

⚙️ Configuration

Required Environment Variables

| Variable | Description | Example | |----------|-------------|---------| | FTP_HOST | FTP server hostname | ftp.example.com | | FTP_USER | FTP username | [email protected] | | FTP_PASSWORD | FTP password | your-secure-password | | FTP_PORT | FTP port (default: 21) | 21 | | FTP_TARGET_DIR | Target directory on FTP | /public/img/ | | FTP_PUBLIC_URL | Public URL base | https://example.com/img/ |

🚀 Usage

Upload and Optimize Image

Upload this image to the server: /path/to/image.jpg

What happens:

1. Image is optimized (WebP + JPEG formats)
2. Uploaded to your FTP server
3. Public URLs returned instantly

List Server Images

Show me the images on the server

Delete Image

Delete image-name.jpg from the server

Test Connection

Test the FTP connection

📋 Available Tools

upload_image_to_server

Upload and optimize an image to FTP server.

Parameters:

• imagePath (required) - Local path to image
• filename (optional) - Custom filename
• optimize (optional) - Enable optimization (default: true)
• formats (optional) - Output formats: ["jpeg", "webp"]

list_server_images

List images on FTP server.

Parameters:

• limit (optional) - Max images to list (default: 20)

delete_server_image

Delete an image from FTP server.

Parameters:

• filename (required) - Filename to delete

test_ftp_connection

Test FTP connection and display config.

🔧 Troubleshooting

Connection Issues

Problem: "Connection refused" or timeout errors

Solutions:

• Verify FTP_HOST is correct
• Check firewall allows FTP (port 21)
• Confirm FTP credentials are valid
• Try passive mode if behind NAT

Upload Fails

Problem: Upload fails but connection works

Solutions:

• Check FTP_TARGET_DIR exists on server
• Verify write permissions for FTP user
• Ensure sufficient disk space on server
• Check filename doesn't contain invalid characters

Optimization Issues

Problem: Image optimization fails

Solutions:

• Verify image file exists and is readable
• Check image format is supported (JPEG, PNG, WebP, GIF)
• Ensure sufficient local disk space for temp files
• Try with optimize: false to isolate issue

📄 License

MIT © Charles Annoni

🔗 Links

• NPM Package
• Report Issues
• MCP Documentation

🙏 Credits

Created by Charles Annoni (GDM-Pixel)

Part of the Nova-Mind ecosystem - AI-powered coaching platform.