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 45 file management tools across 22 protocols, with real-time progress notifications during uploads, downloads, and tree-level sync.
Starting with AeroFTP v4.0.0 the underlying transfer engine is a shared, provider-agnostic DAG scheduler that picks the right transfer shape per call from the provider's capabilities: native multipart upload fan-out on S3 / B2, server-side copy on every backend that supports it, and intra-file segmented downloads when the server proves it honours HTTP Range. The MCP tool surface is unchanged (same names, same arguments, same notifications); progress events are now sourced from the engine's per-node lifecycle. See the architecture page for details.
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.
Once configured, your AI assistant gains access to 75 tools in total. The tables below document the primary operations by safety tier; each remote file and transfer tool is additionally exposed under a matching remote_* alias (and a few under server_*) for cross-profile callers, which brings the advertised total to 75. The three correct_* error-correction tools operate on local files and have no alias.
Safe (read-only)
| Tool |
Description |
list_servers |
List saved server profiles, lean identity fields by default (filters: name_contains, protocol, limit, offset; pass include_capabilities to embed the transfer-capabilities block) |
mcp_info |
Server capabilities, version, supported protocols |
server_info / agent_connect |
Connect and return metadata in one call |
list_files |
List a directory (filters: glob, name_contains, recursive, limit) |
read_file |
Read text content (preview_kb window, soft-truncate inside the 1 MB hard cap) |
file_info |
File or directory metadata (size, mtime, permissions, hash) |
file_versions |
List historical versions where the protocol supports them |
search_files |
Recursive name search with extension/glob filters |
storage_quota |
Storage quota info; optional scan/full/path to compute a real used figure on no-quota backends (bounded recursive scan, mirrors CLI df --scan) |
head_file / tail_file |
First/last N lines of a remote text file |
tree |
Recursive directory tree (depth-capped) |
hashsum |
Server-side checksum (SHA-256 / SHA-1 / MD5 with provider fallback) |
check_tree |
Tree diff with two-sided checksum + per-group caps + omit_match |
sync_doctor |
Preflight risk summary with suggested_next_command |
reconcile |
Categorized size-only diff with elapsed_secs and suggested_next_command |
dedupe (dry-run) |
SHA-256 duplicate detection grouped per size |
Medium (write)
| Tool |
Description |
upload_file / upload_many |
Upload single or multiple files (create_parents recursive mkdir) |
download_file |
Download with progress stream |
transfer / transfer_tree |
Cross-profile copy (single file or recursive tree, dry-run + skip_existing) |
create_directory |
Create a remote directory (recursive parents) |
rename |
Rename/move a file or directory |
edit |
In-place text edit (find/replace) |
touch |
Create empty file or report exists |
sync_tree |
Bidirectional sync with plan[] and per-file delta_files[] |
speed |
Throughput probe (random payload upload + download + SHA-256 integrity) |
High (destructive)
| Tool |
Description |
delete |
Delete a single remote file or directory (dry_run previews the exact files, dirs and bytes and deletes nothing; recursive is opt-in and refuses rather than silently erasing a subtree) |
delete_many |
Batch delete (dry_run preview; caps + configurable backoff) |
cleanup |
Sweep orphan .aerotmp files (dry-run by default) |
remote_versions |
Versioned S3-family only: list, download, restore (server-side copy-forward) and purge a single prior version of an object |
remote_trash |
Versioned S3-family only: browse bucket-wide soft-deleted objects and delete markers under a prefix, undelete (drop a delete marker), and empty the trash with a dry-run preview (never sweeps the live current version) |
Error correction (local .aerocorrect sidecars)
| Tool |
Description |
correct_gen |
Generate a detached .aerocorrect Reed-Solomon recovery sidecar for a local file (par2-style; overhead level 5-50, default 15) |
correct_verify |
Verify a local file against its .aerocorrect sidecar (read-only) |
correct_repair |
Repair a corrupted local file in place from its sidecar (atomic, all-or-nothing, fail-closed re-verify). Optional expect_sha256 authenticity anchor refuses a sidecar declaring a different content hash before any write (requires AeroFTP CLI v4.0.7 or later) |
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
Links
License
GPL-3.0
