mcp-server-ftp

An MCP (Model Context Protocol) server for FTP file operations. Browse, read, download, upload, and manage files on remote FTP servers.

Built with Rust, rmcp, and suppaftp.

Features

• Multi-profile support — configure multiple FTP servers and switch between them
• Full file management — list, read, download, upload, delete, rename, and create directories
• Recursive operations — download or upload entire directory trees
• Binary-safe — binary transfer mode for downloads/uploads, hex preview for non-text files via read_file
• Passive/active mode — configurable per profile
• Connect-per-call — each tool opens a fresh FTP connection, so there's no stale session state. Recursive operations hold one connection for the full traversal.

Tools

Tool	Description
list_profiles	List configured FTP server profiles (no passwords shown)
list_directory	List files/dirs at a remote path (type, size, date, name)
read_file	Read a remote file and return contents as text
download_file	Download a single remote file to a local path
upload_file	Upload a local file to a remote path
download_directory	Recursively download a remote directory
upload_directory	Recursively upload a local directory
delete	Delete a remote file or empty directory
rename	Rename or move a remote file or directory
mkdir	Create a remote directory

All tools accept an optional profile parameter. When omitted, the default_profile from config is used.

Configuration

Create a TOML config file at ~/.config/mcp-server-ftp/config.toml:

default_profile = "myserver"

[[profiles]]
name = "myserver"
host = "ftp.example.com"
port = 21
username = "user"
password = "pass"
tls = false
passive = true
timeout_secs = 30

You can define multiple [[profiles]] blocks to manage several FTP servers.

Profile fields

Field	Default	Description
name	(required)	Profile name used to reference this server
host	(required)	FTP server hostname or IP
port	21	FTP port
username	""	FTP username
password	""	FTP password
tls	false	Enable TLS (not yet implemented)
passive	true	Use passive mode
timeout_secs	30	Connection timeout in seconds

Build

Requires Rust 2024 edition (1.85+).

cargo build --release

The binary is output to target/release/mcp-server-ftp.

Usage with Claude Code

Add to your MCP server configuration:

{
  "mcpServers": {
    "ftp": {
      "command": "/path/to/mcp-server-ftp"
    }
  }
}

Enable debug logging with the RUST_LOG environment variable:

{
  "mcpServers": {
    "ftp": {
      "command": "/path/to/mcp-server-ftp",
      "env": {
        "RUST_LOG": "debug"
      }
    }
  }
}

Project Structure

src/
  main.rs      — Entry point: config load, tracing init, stdio transport
  config.rs    — TOML config parsing, multi-profile support
  server.rs    — MCP tool definitions via rmcp #[tool_router]
  ftp.rs       — Async FTP client wrapper (connect, list, read, download, upload, delete, rename, mkdir)

License

MIT