🗃️ftpmcp🗃️

Ein fokussierter Model Context Protocol-Server für FTP- und FTPS-Dateioperationen. Er implementiert bewusst kein SFTP: SSH-basierte Übertragungen gehören in einen SSH-MCP, anstatt hier Anmeldedaten und Transportlogik zu duplizieren.

Funktionen

• Reines FTP, explizites FTPS und implizites FTPS

• Beliebig viele benannte FTP-Hosts in einem MCP-Prozess

• Remote-Operationen auf das root des jeweiligen Hosts beschränkt

• Lokale Uploads und Downloads auf das local_root des jeweiligen Hosts beschränkt, einschließlich Symlink-Prüfungen

• Schreibgeschützter Modus und separat abgesichertes Löschen

• Strukturierte MCP-Ergebnisse und -Fehler

• Keine Anmeldedaten in Tool-Antworten

Related MCP server: filemanager-mcp-server

Installation

npm install -g @vielhuber/ftpmcp

Konfiguration

{
    "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
        }
    ]
}

Übergeben Sie die Datei an den Server:

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

protocol akzeptiert ftp, ftps und ftps-implicit. Bevorzugen Sie FTPS, wann immer der Server es unterstützt. Reines FTP sendet Anmeldedaten und Inhalte ohne Transportverschlüsselung.

root ist das sichtbare Remote-Stammverzeichnis für jeden Tool-Pfad auf diesem Host. Konfigurieren Sie das FTP-Konto selbst mit einem äquivalenten serverseitigen chroot: FTP kann nicht zuverlässig verhindern, dass ein vom Server bereitgestellter symbolischer Link aus einer rein clientseitigen Pfadgrenze herauszeigt.

local_root schränkt lokale Uploads und Downloads ein. Sowohl relative Pfade als auch absolute Pfade unterhalb dieses Verzeichnisses werden akzeptiert.

read_only: true blockiert Uploads, das Erstellen von Verzeichnissen, Umbenennungen und Löschungen. Zum Löschen ist zusätzlich allow_delete: true erforderlich.

Jeder Vorgang außer list_hosts erfordert den ausgewählten host-Alias.

MCP-Client

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

Werkzeuge

Entwicklung

npm install
npm test
npm run format:check

Lizenz

MIT