AeroFTP MCP Server

Configure the AeroFTP MCP server for Claude Code, Claude Desktop, Cursor, and Windsurf with one click. Gives your AI assistant access to 16 file management tools across 28 protocols.

Features

Multi-target - Install for Claude Code, Claude Desktop, Cursor, and Windsurf simultaneously
Auto-detection - Only shows targets that are installed on your system
Safe merge - Preserves existing MCP servers in your config
Status bar indicator - Always know if the MCP server is active
Diagnostics - Health check across all detected targets
Cross-platform - Linux, macOS, Windows
Getting Started walkthrough - Guided setup in 3 steps

Prerequisites

AeroFTP must be installed with the CLI (aeroftp-cli) available in your PATH.

Linux

| Method | Command | |--------|---------| | Snap | sudo snap install aeroftp | | AUR | yay -S aeroftp-bin | | Deb | sudo dpkg -i aeroftp_*.deb | | RPM | sudo rpm -i aeroftp-*.rpm | | AppImage | Download from GitHub Releases |

macOS / Windows

Download the latest installer from GitHub Releases.

Usage

Automatic

On first activation, the extension detects aeroftp-cli and offers to configure the MCP server automatically.

Commands

Open the Command Palette (Ctrl+Shift+P / Cmd+Shift+P):

| Command | Description | |---------|-------------| | AeroFTP: Install MCP Server | Register the MCP server (multi-target picker) | | AeroFTP: Remove MCP Server | Remove the MCP server from selected targets | | AeroFTP: MCP Server Status | Show per-target configuration details | | AeroFTP: Diagnose Installation | Run health check across all targets |

Settings

| Setting | Default | Description | |---------|---------|-------------| | aeroftp-mcp.cliPath | "" | Absolute path to aeroftp-cli (empty = auto-detect) | | aeroftp-mcp.showStatusBar | true | Show status indicator in the status bar |

Supported Targets

| Target | Config path | |--------|------------| | Claude Code | ~/.claude/.mcp.json | | Claude Desktop (Windows) | %APPDATA%\Claude\claude_desktop_config.json | | Claude Desktop (macOS) | ~/Library/Application Support/Claude/claude_desktop_config.json | | Cursor | ~/.cursor/mcp.json | | Windsurf | ~/.codeium/windsurf/mcp_config.json |

The extension auto-detects which targets are installed and only shows those in the picker. Each target receives the same entry:

{
  "mcpServers": {
    "aeroftp": {
      "command": "aeroftp-cli",
      "args": ["mcp"]
    }
  }
}

Existing MCP servers in each config file are preserved. The MCP server communicates via JSON-RPC over stdio.

Available MCP Tools

Once configured, your AI assistant gains access to 16 tools:

Safe (read-only)

| Tool | Description | |------|-------------| | list_directory | List files in a directory | | read_file | Read file content | | stat | Get file/directory metadata | | search | Search for files by name pattern | | get_quota | Get storage quota info | | list_profiles | List saved server profiles | | connect | Connect to a saved profile | | disconnect | Disconnect from current server | | server_info | Get server/protocol information |

Medium (write operations)

| Tool | Description | |------|-------------| | download_file | Download file to local path | | upload_file | Upload local file to remote | | create_directory | Create a remote directory | | rename | Rename/move a file or directory | | copy | Server-side copy (if supported) |

High (destructive)

| Tool | Description | |------|-------------| | delete_file | Delete a remote file | | delete_directory | Delete a remote directory |

Rate Limits

| Category | Limit | |----------|-------| | Read (list, stat, search) | 60/min | | Write (upload, mkdir, rename) | 30/min | | Delete | 10/min |

Supported Protocols

FTP, FTPS, SFTP, WebDAV, S3 (+ Wasabi, Cloudflare R2, DigitalOcean Spaces, Backblaze B2, MinIO), Google Drive, Dropbox, OneDrive, MEGA, Box, pCloud, Azure Blob, 4shared, Filen, Zoho WorkDrive, Internxt, kDrive, Koofr, Jottacloud, FileLu, Yandex Disk, OpenDrive

License

GPL-3.0

MCP Servers