# ftp-mcp

MCP server for FTP/FTPS/SFTP operations — full FileZilla feature set for AI agents.

## Installation

### OpenCode

Add to your `opencode.json` config:

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "ftp-mcp": {
      "type": "local",
      "command": ["npx", "-y", "github:kemalabuteliyte/ftp-mcp"],
      "enabled": true
    }
  }
}
```

### Claude Code / Claude Desktop

Add to your MCP config (`~/.claude/settings.json` or Claude Desktop config):

```json
{
  "mcpServers": {
    "ftp-mcp": {
      "command": "npx",
      "args": ["-y", "github:kemalabuteliyte/ftp-mcp"]
    }
  }
}
```

### Cursor / Windsurf

Add to your MCP settings:

```json
{
  "mcpServers": {
    "ftp-mcp": {
      "command": "npx",
      "args": ["-y", "github:kemalabuteliyte/ftp-mcp"]
    }
  }
}
```

### Manual install

```bash
npm install -g github:kemalabuteliyte/ftp-mcp
```

Then use `ftp-mcp` as the command in any MCP client config.

## Features

**36 tools** covering all FileZilla operations:

### Connection Management
- `ftp_connect` — Connect to FTP/FTPS/SFTP server
- `ftp_disconnect` — Close a connection
- `ftp_list_connections` — List active connections
- `ftp_connection_info` — Get connection details

### Site Manager
- `ftp_add_site` — Save connection profile
- `ftp_remove_site` — Delete saved site
- `ftp_list_sites` — List saved profiles
- `ftp_edit_site` — Update site config

### Navigation
- `ftp_pwd` — Print working directory
- `ftp_cd` — Change directory
- `ftp_list` — List directory (permissions, size, date)
- `ftp_tree` — Recursive tree view

### File Operations
- `ftp_upload` — Upload file (binary/ascii/auto)
- `ftp_download` — Download file
- `ftp_delete` — Delete file
- `ftp_rename` — Rename file/directory
- `ftp_move` — Move file
- `ftp_copy` — Copy file on server
- `ftp_read` — Read remote file contents
- `ftp_write` — Write content to remote file
- `ftp_append` — Append to remote file
- `ftp_stat` — Get file info
- `ftp_exists` — Check if path exists

### Directory Operations
- `ftp_mkdir` — Create directory (recursive option)
- `ftp_rmdir` — Remove directory (recursive option)
- `ftp_dir_size` — Calculate directory size

### Bulk Transfers
- `ftp_upload_directory` — Upload entire directory
- `ftp_download_directory` — Download entire directory
- `ftp_sync` — Sync local/remote directories
- `ftp_mirror` — Mirror directories (one-way sync with delete)

### Permissions
- `ftp_chmod` — Change permissions (recursive option)
- `ftp_chown` — Change ownership (SFTP only)

### Search & Compare
- `ftp_find` — Search files by name pattern
- `ftp_grep` — Search file contents on server
- `ftp_compare` — Compare local vs remote directories
- `ftp_checksum` — File checksum verification

## Protocols

| Protocol | Library | Default Port |
|----------|---------|-------------|
| FTP | basic-ftp | 21 |
| FTPS | basic-ftp | 990 |
| SFTP | ssh2-sftp-client | 22 |

## Multi-Server Support

Connect to multiple servers simultaneously with named connections:

```
ftp_connect(name: "prod", host: "prod.example.com", protocol: "sftp", ...)
ftp_connect(name: "staging", host: "staging.example.com", protocol: "ftp", ...)
ftp_list(connection: "prod", path: "/var/www")
ftp_sync(connection: "staging", localPath: "./dist", remotePath: "/public_html", direction: "local-to-remote")
```

## Site Manager

Save frequently used connections to `~/.ftp-mcp/sites.json`:

```
ftp_add_site(name: "myserver", host: "example.com", protocol: "sftp", username: "deploy", privateKeyPath: "~/.ssh/id_rsa")
ftp_connect(name: "session1", site: "myserver")
```

## License

MIT