FTP MCP Server (multi-server version)

A local server for uploading/listing/deleting files to multiple FTP servers from a single MCP server.

Each tool call specifies which server to operate on via the server parameter (alias). Upload targets are specified by local absolute paths, and the file contents themselves are not included in the tool call arguments (this avoids putting binary data such as images into the LLM context).

Main use case: the first half of a two-step flow in which generated images are uploaded to a public folder on a web server, and the URL is passed to wp_upload_media_from_url (wp-mcp) to formally register them in the WordPress media library.

1. Setup

cd ftp-mcp
npm install

Copy servers.json.example to servers.json and write the information for all servers you manage (this file contains credentials for all servers, so never publish, share, or commit it to Git. It is included in .gitignore).

cp servers.json.example servers.json

{
  "mysite": {
    "host": "ftp.example.com",
    "user": "user@example.com",
    "password": "xxxxxxxx",
    "base_path": "/resource",
    "public_base_url": "https://example.com/resource"
  }
}

• base_path: the root folder for uploads on this server (absolute path from the FTP root). All tools specify files with relative paths starting from this base_path.

• public_base_url: the public URL base corresponding to base_path. After upload, a URL combining this with the relative path is returned.

• port (optional, default 21), secure (optional, default false. Set to true to use FTPS (implicit TLS)).

Related MCP server: mcp-ftp-server

2. Registration with Claude Code

In the root folder of the project using Claude Code, add the MCP server information to .mcp.json.

{
  "mcpServers": {
    "ftp": {
      "command": "node",
      "args": ["/MCPの保存パス/ftp-mcp/index.js"],
      "env": {
        "SERVERS_CONFIG_PATH": "/MCPの保存パス/ftp-mcp/servers.json"
      }
    }
  }
}

3. Provided tools

• ftp_list_servers — get the list of configured servers (alias, host, base_path, public_base_url)

• ftp_upload_file — upload a local file (absolute path) and return the public URL. Subfolders included in remote_path are created automatically

• ftp_list_files — get the list of files in the specified folder starting from base_path

• ftp_delete_file — delete a file by specifying a relative path starting from base_path (intended for cleaning up temporary files after importing into the WordPress media library)

Notes

• Uses the basic-ftp dependency library (FTP/FTPS support, Promise-based).

• Paths containing .. in remote_path will result in an error (to prevent writing/deleting outside base_path).