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:

Utilice el script build-windows.bat proporcionado que maneja problemas de compilación comunes
Asegúrese de que Node.js y npm estén instalados correctamente
Intente ejecutar el compilador de TypeScript directamente: npx tsc
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 entorno	Descripción	Por defecto
`FTP_HOST`	Nombre de host o dirección IP del servidor FTP	host local
`FTP_PORT`	Puerto del servidor FTP	21
`FTP_USER`	Nombre de usuario FTP	anónimo
`FTP_PASSWORD`	Contraseña FTP	(cadena vacía)
`FTP_SECURE`	Utilice 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 herramienta	Descripción
`list-directory`	Listar el contenido de un directorio FTP
`download-file`	Descargar un archivo del servidor FTP
`upload-file`	Subir un archivo al servidor FTP
`create-directory`	Crear un nuevo directorio en el servidor FTP
`delete-file`	Eliminar un archivo del servidor FTP
`delete-directory`	Eliminar 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)

MCP Server for FTP Access

Integrations