AI导哈

FTP文件管理MCP服务器

这是一个MCP服务器，用于在AI助手中提供FTP文件浏览、读取、下载、上传、删除、重命名和目录管理等操作，适用于远程FTP文件管理场景。

  • by codeChap
  • Rust
  • 本地部署
  • 更新于
在 GitHub 查看 codeChap/mcp-server-ftp

使用说明

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

相关 MCP