Repository navigation
v0.1.0 - The deploy button for AI coding agents
First public release.
ftp-deploy-mcp connects AI coding agents (Claude Code, Claude Desktop, Cursor, Windsurf, Trae, Antigravity) to your own FTP / FTPS / SFTP servers through the Model Context Protocol.
Highlights
- 10 MCP tools - list, read, upload, download, mkdir, rename, delete, test, list_servers, and a recursive
ftp_deploywith dry-run - Multi-server config (
ftp-servers.json) with${ENV:...}secret substitution and SSH key auth - Security model: per-server path jail (no
../escape, root undeletable), per-server read-only mode, credentials never enter the model context, gitignore-like excludes at any depth (.env,node_modules,.git,*.log) - FileZilla import - convert
sitemanager.xmlin one command (incl. implicit FTPS and RemoteDir decoding) - One-command setup -
install.cmd/install.shruns a wizard that imports your sites, tests connections, and auto-writes the MCP config of every detected client (with timestamped backups) doctorread-only diagnostic- 189 e2e assertions against real local FTP + SFTP servers, green on Linux / Windows / macOS x Node 18 / 20 / 22
Install
git clone https://github.com/alebgl77/ftp-deploy-mcp.git
cd ftp-deploy-mcp
# Windows: double-click install.cmd - macOS/Linux:
./install.sh