local-only server
The server can only run on the client’s local machine because it depends on local resources.
Integrations
Allows interaction with FTP servers to list directory contents, download and upload files, create directories, and delete files/directories remotely.
MCP Server for FTP Access
This Model Context Protocol (MCP) server provides tools for interacting with FTP servers. It allows Claude.app to list directories, download and upload files, create directories, and delete files/directories on FTP servers.
Features
- List Directory Contents: View files and folders on the FTP server
- Download Files: Retrieve file content from the FTP server
- Upload Files: Create new files or update existing ones
- Create Directories: Make new folders on the FTP server
- Delete Files/Directories: Remove files or directories
Installation
Installing via Smithery
To install mcp-server-ftp for Claude Desktop automatically via Smithery:
Prerequisites
- Node.js 16 or higher
- Claude for Desktop (or other MCP-compatible client)
Building from Source
Linux/macOS
Windows
The build-windows.bat
script handles dependency installation and building on Windows systems, with fallback options if the TypeScript compiler has issues.
Configuration
To use this server with Claude for Desktop, add it to your configuration file:
MacOS/Linux
Edit ~/Library/Application Support/Claude/claude_desktop_config.json
:
Windows
Edit %APPDATA%\Claude\claude_desktop_config.json
:
Troubleshooting Windows Build Issues
If you encounter build issues on Windows:
- Use the provided
build-windows.bat
script which handles common build issues - Make sure Node.js and npm are properly installed
- Try running the TypeScript compiler directly:
npx tsc
- If you still have issues, you can use the pre-compiled files in the
build
directory by running:Copy
Configuration Options
Environment Variable | Description | Default |
---|---|---|
FTP_HOST | FTP server hostname or IP address | localhost |
FTP_PORT | FTP server port | 21 |
FTP_USER | FTP username | anonymous |
FTP_PASSWORD | FTP password | (empty string) |
FTP_SECURE | Use secure FTP (FTPS) | false |
Usage
After configuring and restarting Claude for Desktop, you can use natural language to perform FTP operations:
- "List the files in the /public directory on my FTP server"
- "Download the file /data/report.txt from the FTP server"
- "Upload this text as a file called notes.txt to the FTP server"
- "Create a new directory called 'backups' on the FTP server"
- "Delete the file obsolete.txt from the FTP server"
- "Remove the empty directory /old-project from the FTP server"
Available Tools
Tool Name | Description |
---|---|
list-directory | List contents of an FTP directory |
download-file | Download a file from the FTP server |
upload-file | Upload a file to the FTP server |
create-directory | Create a new directory on the FTP server |
delete-file | Delete a file from the FTP server |
delete-directory | Delete a directory from the FTP server |
Security Considerations
- FTP credentials are stored in the Claude configuration file. Ensure this file has appropriate permissions.
- Consider using FTPS (secure FTP) by setting
FTP_SECURE=true
if your server supports it. - The server creates temporary files for uploads and downloads in your system's temp directory.
License
MIT
You must be authenticated.
Enables Claude to interact with FTP servers through natural language commands, allowing users to list directories, download/upload files, create directories, and delete files/directories on FTP servers.