MCP FTP Server

Servidor MCP (Model Context Protocol) para operaciones FTP. Compatible con Claude Desktop y Claude CLI.

Instalación

# Clonar o copiar el proyecto
cd mcp-ftp-server

# Instalar dependencias
npm install

# Compilar
npm run build

Related MCP server: SSH Remote MCP Server

Configuración

Variables de Entorno (Recomendado)

FTP_HOST=ftp.tuservidor.com
FTP_PORT=21                    # Opcional, default: 21
FTP_USER=usuario
FTP_PASSWORD=contraseña
FTP_SECURE=false               # true para FTPS

Claude Desktop

Edita tu archivo de configuración:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "ftp": {
      "command": "node",
      "args": ["/ruta/completa/a/mcp-ftp-server/dist/index.js"],
      "env": {
        "FTP_HOST": "ftp.tuservidor.com",
        "FTP_PORT": "21",
        "FTP_USER": "tu_usuario",
        "FTP_PASSWORD": "tu_contraseña",
        "FTP_SECURE": "false"
      }
    }
  }
}

Claude CLI

Opción 1: Variables de entorno en la sesión

export FTP_HOST=ftp.tuservidor.com
export FTP_USER=usuario
export FTP_PASSWORD=contraseña
claude

Opción 2: Archivo .mcp.json en tu proyecto

{
  "mcpServers": {
    "ftp": {
      "command": "node",
      "args": ["./mcp-ftp-server/dist/index.js"],
      "env": {
        "FTP_HOST": "ftp.tuservidor.com",
        "FTP_USER": "usuario",
        "FTP_PASSWORD": "contraseña"
      }
    }
  }
}

Opción 3: Configuración global en ~/.claude/settings.json

{
  "mcpServers": {
    "ftp": {
      "command": "node",
      "args": ["/ruta/absoluta/mcp-ftp-server/dist/index.js"],
      "env": {
        "FTP_HOST": "ftp.tuservidor.com",
        "FTP_USER": "usuario",
        "FTP_PASSWORD": "contraseña"
      }
    }
  }
}

Tools Disponibles

Ejemplos de Uso

Una vez configurado, puedes pedirle a Claude:

• "Lista los archivos en el servidor FTP"

• "Descarga el archivo config.json del FTP a mi carpeta local"

• "Sube el archivo backup.sql al directorio /backups en el FTP"

• "Lee el contenido del archivo readme.txt del servidor"

• "Crea una carpeta llamada 'proyectos' en el FTP"

• "Muestra el estado de la conexión FTP"

Características

• ✅ Conexión automática usando variables de entorno

• ✅ Soporte FTPS (FTP sobre TLS)

• ✅ Lectura/escritura de archivos en memoria

• ✅ Creación recursiva de directorios

• ✅ Compatible con Claude Desktop y Claude CLI

• ✅ Manejo de errores descriptivo

Seguridad

⚠️ Importante: Las credenciales FTP se almacenan en texto plano en los archivos de configuración. Asegúrate de:

1. No commitear archivos de configuración con credenciales a git

2. Usar permisos restrictivos en los archivos de configuración

3. Considerar usar FTPS (FTP_SECURE=true) para conexiones encriptadas

Desarrollo

# Modo desarrollo con recompilación automática
npm run dev

# Compilar
npm run build

# Ejecutar directamente
npm start

Licencia

MIT