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

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

Tool	Descripción
ftp_connect	Conectar a servidor FTP (opcional si usas env vars)
ftp_disconnect	Desconectar del servidor
ftp_status	Ver estado de la conexión
ftp_pwd	Obtener directorio actual
ftp_cd	Cambiar de directorio
ftp_list	Listar archivos y carpetas
ftp_download	Descargar archivo a local
ftp_upload	Subir archivo al servidor
ftp_read	Leer contenido de archivo remoto
ftp_write	Escribir contenido a archivo remoto
ftp_delete	Eliminar archivo
ftp_mkdir	Crear directorio
ftp_rmdir	Eliminar directorio
ftp_rename	Renombrar/mover archivo o carpeta
ftp_size	Obtener tamaño de archivo

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