Alxspiker MCP Server Ftp

🚀 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 an FTP server.

✨ 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.
• Create directories: Make new folders on the FTP server.
• Delete files/directories: Remove files or directories from the FTP server.

📦 Installation

Install via Smithery

To 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 alternative options for TypeScript compiler issues.

📚 Configuration

To use this server with Claude Desktop:

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"
      }
    }
  }
}

🔧 Troubleshooting

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

⚠️ Security Considerations

• FTP credentials are stored in the Claude configuration file. Ensure the 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 the system's temporary directory.

📄 License

MIT