MCP Server
Connect your AI assistant to AeroFTP's full integration surface - 7 transport protocols, 20+ native provider integrations, 40+ pre-configured presets - through the Model Context Protocol. One configuration, 39 curated tools, zero custom code.
Supported AI Tools
Claude Code
CLI & VS Code
Claude Desktop
Windows & macOS
Cursor
AI-first editor
Windsurf
Codeium IDEQuick Setup
1 Install AeroFTP CLI
# Linux (Snap)
sudo snap install aeroftp
# Linux (AUR)
yay -S aeroftp-bin
# Or download from GitHub Releases
# .deb, .rpm, .AppImage, .msi, .dmg2 Install VS Code Extension
ext install axpdev-lab.aeroftp-mcpOr search "AeroFTP MCP" in the VS Code Extensions panel.
3 Done
The extension auto-detects your installed AI tools and configures the MCP server. Open the Command Palette:
Ctrl+Shift+P → AeroFTP: Install MCP ServerSelect which tools to configure (Claude Code, Claude Desktop, Cursor, Windsurf) and click Install.
39 MCP Tools
Curated tool catalog the AeroFTP MCP server exposes to AI clients (Claude Code, Claude Desktop, Cursor, Windsurf). Real names verified against aeroftp-cli v3.8.1.
| Tool | Level | Description |
|---|---|---|
| Safe - Read-Only (18 tools) | ||
aeroftp_list_servers | safe | List saved server profiles from the encrypted vault. Passwords are never exposed. |
aeroftp_mcp_info | safe | Diagnostics about the running MCP process: version, supported protocols, capabilities. |
aeroftp_agent_connect | safe | Single-shot connect: one JSON payload with connect / capabilities / quota / path blocks. |
aeroftp_list_files | safe | List files and directories. Pagination, sort, files-only / dirs-only filters. |
aeroftp_read_file | safe | Read a remote text file preview (preview_kb soft-truncation within a 1 MB cap). |
aeroftp_file_info | safe | Metadata for a remote file or directory (size, mtime, permissions, hash). |
aeroftp_search_files | safe | Glob search on a remote server, with pagination and sort. |
aeroftp_storage_quota | safe | Storage usage and quota for a remote server. |
aeroftp_hashsum | safe | Streamed SHA-256 / SHA-1 / MD5 / BLAKE3 of a remote file (alias: checksum). |
aeroftp_head | safe | First N lines of a remote UTF-8 text file (default 50, cap 10000). |
aeroftp_tail | safe | Last N lines of a remote UTF-8 text file (default 50, cap 10000). |
aeroftp_tree | safe | Recursive directory tree as flat JSON, bounded by max_depth / max_entries. |
aeroftp_check_tree | safe | Local-vs-remote diff: match / differ / missing_local / missing_remote. |
aeroftp_reconcile | safe | Diff superset of check_tree with elapsed time and suggested_next_command. |
aeroftp_sync_doctor | safe | Preflight risk summary for a sync. Lighter than sync_tree dry_run. |
aeroftp_dedupe | safe | SHA-256 duplicate detection grouped per size (dry-run by default). |
aeroftp_debug_snapshot | safe | Static diagnostic snapshot: host / runtime info plus the last N redacted log lines. |
aeroftp_debug_run_test | safe | Run one self-contained diagnostic probe (e.g. known_hosts). |
| Medium - Write (13 tools) | ||
aeroftp_download_file | medium | Download a remote file to a local path. |
aeroftp_upload_file | medium | Upload a local file or inline text content to a remote server. |
aeroftp_upload_many | medium | Batch upload of multiple local files in a single call. |
aeroftp_create_directory | medium | Create a directory on a remote server. |
aeroftp_rename | medium | Rename or move a file / directory. |
aeroftp_edit | medium | Find-and-replace on a remote UTF-8 text file without downloading it. |
aeroftp_sync_tree | medium | Synchronize a directory (upload / download / both). dry_run, delete_orphans. |
aeroftp_transfer | medium | Cross-profile single-file transfer between two saved profiles. |
aeroftp_transfer_tree | medium | Cross-profile recursive directory transfer. |
aeroftp_touch | medium | Create an empty file, or report action: "exists". |
aeroftp_speed | medium | Throughput benchmark: upload + download + optional SHA-256 + cleanup. |
aeroftp_benchmark | medium | Run the AeroFTP community benchmark suite against a saved profile. |
aeroftp_close_connection | medium | Close a pooled server connection explicitly (forces reconnect). |
| High - Destructive / Execution (4 tools) | ||
aeroftp_delete | high | Delete one or more remote entries. |
aeroftp_delete_many | high | Batch delete of remote entries. |
aeroftp_cleanup | high | Find / remove orphan .aerotmp files from interrupted uploads (dry-run by default). |
aeroftp_server_exec | high | Execute a vault-backed server operation without exposing credentials. |
Wire names use the aeroftp_ prefix; the server also registers remote_* / server_* aliases for the same tools (70 endpoints total). agent-info reports 39 curated native tools. Upload, download and sync tools emit notifications/progress when the client passes a progressToken.
Built-in Safety
Rate Limits
| Category | Limit |
|---|---|
| Read (list, stat, search) | 60/min |
| Write (upload, mkdir, rename) | 30/min |
| Delete | 10/min |
Security
- Credential isolation - passwords never exposed to AI
- Audit logging - every tool call logged locally
- Path validation - traversal attacks blocked
- Input sanitization - size caps and null byte rejection
Manual Configuration
If you prefer manual configuration without the VS Code extension, add this to your AI tool's config file:
{
"mcpServers": {
"aeroftp": {
"command": "aeroftp-cli",
"args": ["mcp"]
}
}
}| Tool | 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 |
Integration Surface
All MCP tools work transparently across AeroFTP's three integration tiers. Server profiles are resolved by name from the encrypted vault - the AI model never sees credentials.
7 Transport Protocols
FTP, FTPS, SFTP, WebDAV, S3, Azure Blob, OpenStack Swift - native wire-level support, full streaming, AES-256-GCM credential vault.
20+ Native Providers
Google Drive, Dropbox, OneDrive, MEGA, Box, pCloud, Filen, Zoho WorkDrive, Internxt, kDrive, Koofr, Jottacloud, FileLu, Yandex Disk, OpenDrive, 4shared, Drime, GitHub, GitLab, Immich.
40+ Pre-configured Presets
AWS S3, Backblaze B2, Cloudflare R2, Wasabi, DigitalOcean Spaces, MinIO, Storj, IDrive e2, Hetzner, Tencent COS, Alibaba OSS, Oracle, Yandex Cloud, Nextcloud, Seafile, InfiniCLOUD, Jianguoyun, CloudMe, SourceForge.
E2E Encryption
Zero-knowledge providers (MEGA, Filen, Internxt) and AeroVault containers (AES-256-GCM-SIV) work transparently through the same MCP tool surface.
AeroRsync Delta Sync
Native rsync protocol 31 in pure Rust on SFTP. Cross-OS first-class (Linux, macOS, Windows) since v3.6.1. aeroftp_sync_tree uses it transparently when eligible.
Pool Auto-Reset
Connection pool transparently closes and reopens after transient transport failures (553, 550, broken pipes). No manual aeroftp_close_connection needed.
