MCP Server for FTP Access

by alxspiker
Verified

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Allows interaction with FTP servers to list directory contents, download and upload files, create directories, and delete files/directories remotely.

Servidor MCP para acceso FTP

Este servidor de Protocolo de Contexto de Modelo (MCP) proporciona herramientas para interactuar con servidores FTP. Permite a Claude.app listar directorios, descargar y subir archivos, crear directorios y eliminar archivos/directorios en servidores FTP.

Características

  • Listar contenidos del directorio : ver archivos y carpetas en el servidor FTP
  • Descargar archivos : recuperar el contenido del archivo del servidor FTP
  • Subir archivos : crear nuevos archivos o actualizar los existentes
  • Crear directorios : crea nuevas carpetas en el servidor FTP
  • Eliminar archivos/directorios : eliminar archivos o directorios

Instalación

Instalación mediante herrería

Para instalar mcp-server-ftp para Claude Desktop automáticamente a través de Smithery :

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

Prerrequisitos

  • Node.js 16 o superior
  • Claude para escritorio (u otro cliente compatible con MCP)

Construyendo desde la fuente

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

Ventanas

# 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

El script build-windows.bat maneja la instalación y compilación de dependencias en sistemas Windows, con opciones de respaldo si el compilador TypeScript tiene problemas.

Configuración

Para utilizar este servidor con Claude for Desktop, agréguelo a su archivo de configuración:

MacOS/Linux

Editar ~/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" } } } }

Ventanas

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

Solución de problemas de compilación de Windows

Si encuentra problemas de compilación en Windows:

  1. Utilice el script build-windows.bat proporcionado que maneja problemas de compilación comunes
  2. Asegúrese de que Node.js y npm estén instalados correctamente
  3. Intente ejecutar el compilador de TypeScript directamente: npx tsc
  4. Si aún tiene problemas, puede usar los archivos precompilados en el directorio build ejecutando:
    node path\to\mcp-server-ftp\build\index.js

Opciones de configuración

Variable de entornoDescripciónPor defecto
FTP_HOSTNombre de host o dirección IP del servidor FTPhost local
FTP_PORTPuerto del servidor FTP21
FTP_USERNombre de usuario FTPanónimo
FTP_PASSWORDContraseña FTP(cadena vacía)
FTP_SECUREUtilice FTP seguro (FTPS)FALSO

Uso

Después de configurar y reiniciar Claude for Desktop, puede usar lenguaje natural para realizar operaciones FTP:

  • "Enumerar los archivos en el directorio /public de mi servidor FTP"
  • "Descargar el archivo /data/report.txt del servidor FTP"
  • Sube este texto como un archivo llamado notes.txt al servidor FTP
  • "Crear un nuevo directorio llamado 'copias de seguridad' en el servidor FTP"
  • "Eliminar el archivo obsolete.txt del servidor FTP"
  • "Eliminar el directorio vacío /old-project del servidor FTP"

Herramientas disponibles

Nombre de la herramientaDescripción
list-directoryListar el contenido de un directorio FTP
download-fileDescargar un archivo del servidor FTP
upload-fileSubir un archivo al servidor FTP
create-directoryCrear un nuevo directorio en el servidor FTP
delete-fileEliminar un archivo del servidor FTP
delete-directoryEliminar un directorio del servidor FTP

Consideraciones de seguridad

  • Las credenciales FTP se almacenan en el archivo de configuración de Claude. Asegúrese de que este archivo tenga los permisos adecuados.
  • Considere usar FTPS (FTP seguro) configurando FTP_SECURE=true si su servidor lo admite.
  • El servidor crea archivos temporales para cargas y descargas en el directorio temporal de su sistema.

Licencia

Instituto Tecnológico de Massachusetts (MIT)

You must be authenticated.

A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

Permite a Claude interactuar con servidores FTP a través de comandos de lenguaje natural, lo que permite a los usuarios enumerar directorios, descargar/cargar archivos, crear directorios y eliminar archivos/directorios en servidores FTP.

  1. Features
    1. Installation
      1. Installing via Smithery
      2. Prerequisites
      3. Building from Source
    2. Configuration
      1. MacOS/Linux
      2. Windows
    3. Troubleshooting Windows Build Issues
      1. Configuration Options
        1. Usage
          1. Available Tools
            1. Security Considerations
              1. License
                ID: ff9z4aw2np