🗃️ftpmcp🗃️

Un servidor Model Context Protocol centrado en operaciones de archivos FTP y FTPS. Deliberadamente no implementa SFTP: las transferencias basadas en SSH pertenecen a un MCP de SSH en lugar de duplicar credenciales y lógica de transporte aquí.

Características

• FTP plano, FTPS explícito y FTPS implícito

• Cualquier número de hosts FTP nombrados en un solo proceso MCP

• Operaciones remotas restringidas a la root de cada host

• Cargas y descargas locales restringidas al local_root de cada host, incluyendo comprobaciones de enlaces simbólicos

• Modo de solo lectura y eliminación protegida por separado

• Resultados y errores MCP estructurados

• Sin valores de credenciales en las respuestas de las herramientas

Related MCP server: filemanager-mcp-server

Instalación

npm install -g @vielhuber/ftpmcp

Configuración

{
    "hosts": [
        {
            "host": "website",
            "hostname": "ftp.example.com",
            "protocol": "ftps",
            "port": 21,
            "username": "user",
            "password": "your_password",
            "root": "/public_html",
            "local_root": "/host/data",
            "read_only": false,
            "allow_delete": false,
            "tls_reject_unauthorized": true,
            "timeout": 30000
        }
    ]
}

Pase el archivo al servidor:

export FTP_CONFIG_FILE=/path/to/ftp-hosts.json

protocol acepta ftp, ftps y ftps-implicit. Prefiera FTPS siempre que el servidor lo admita. FTP plano envía credenciales y contenido sin cifrado de transporte.

root es la raíz remota visible para cada ruta de herramienta en ese host. Configure la cuenta FTP con un chroot equivalente en el servidor: FTP no puede evitar de forma fiable que un enlace simbólico proporcionado por el servidor apunte fuera de un límite de ruta meramente del lado del cliente.

local_root restringe las cargas y descargas locales. Tanto las rutas relativas como las absolutas por debajo de ese directorio se aceptan.

read_only: true bloquea cargas, creación de directorios, renombrados y eliminación. La eliminación además requiere allow_deletion: true.

Cada operación excepto list_hosts requiere el alias host seleccionado.

Cliente MCP

{
    "mcpServers": {
        "ftp": {
            "command": "ftpmcp",
            "env": {
                "FTP_CONFIG_FILE": "/path/to/ftp-hosts.json"
            }
        }
    }
}

Herramientas

Desarrollo

npm install
npm test
npm run format:check

Licencia

MIT