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

FTP MCP

Documentation