MCP Server Ftp

🚀 MCP Server for FTP Access

This MCP server provides tools for interacting with FTP servers, enabling Claude.app to list directory contents, download and upload files, create directories, and delete files/directories.

🚀 Quick Start

This Model Context Protocol (MCP) server offers tools for interacting with FTP servers. It allows Claude.app to list directory contents, download and upload files, create directories, and delete files/directories.

✨ Features

• List Directory Contents: View files and folders on the FTP server.
• Download Files: Retrieve file contents from the FTP server.
• Upload Files: Create new files or update existing ones on the FTP server.
• Create Directories: Create new folders on the FTP server.
• Delete Files/Directories: Remove files or directories from the FTP server.

📦 Installation

Install via Smithery

Automatically install mcp-server-ftp for Claude Desktop via Smithery:

npx -y @smithery/cli install @alxspiker/mcp-server-ftp --client claude

Prerequisites

• Node.js 16 or higher.
• Claude Desktop (or other MCP-compatible clients).

Build from Source

Linux/macOS

# Clone the repository
git clone https://github.com/alxspiker/mcp-server-ftp.git
cd mcp-server-ftp

# Install dependencies
npm install

# Build the project
npm run build

Windows

# Clone the repository
git clone https://github.com/alxspiker/mcp-server-ftp.git
cd mcp-server-ftp

# Run the Windows build helper script
build-windows.bat

The build-windows.bat script handles dependency installation and building on Windows systems, with fallback options for TypeScript compiler issues.

📚 Documentation

Configuration

To use this server with Claude Desktop, add it to the configuration file:

MacOS/Linux

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "ftp-server": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-server-ftp/build/index.js"],
      "env": {
        "FTP_HOST": "ftp.example.com",
        "FTP_PORT": "21",
        "FTP_USER": "your-username",
        "FTP_PASSWORD": "your-password",
        "FTP_SECURE": "false"
      }
    }
  }
}

Windows

Edit %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "ftp-server": {
      "command": "node",
      "args": ["C:\\path\\to\\mcp-server-ftp\\build\\index.js"],
      "env": {
        "FTP_HOST": "ftp.example.com",
        "FTP_PORT": "21",
        "FTP_USER": "your-username",
        "FTP_PASSWORD": "your-password",
        "FTP_SECURE": "false"
      }
    }
  }
}

Security Considerations

• FTP credentials are stored in the Claude configuration file. Ensure the file has appropriate permissions.
• Consider setting FTP_SECURE=true to use FTPS (secure FTP) if your server supports it.
• The server creates temporary files for uploads and downloads in the system's temporary directory.

📄 License

MIT