🗃️ftpmcp🗃️

Сфокусированный сервер Model Context Protocol для операций с файлами по FTP и FTPS. Он намеренно не реализует SFTP: передачи на основе SSH относятся к SSH MCP, а не дублируют здесь учётные данные и транспортную логику.

Возможности

• Обычный FTP, явный FTPS и неявный FTPS

• Любое количество именованных FTP-хостов в одном процессе MCP

• Удалённые операции ограничены root каждого хоста

• Локальные загрузки и скачивания ограничены local_root каждого хоста, включая проверки символьных ссылок

• Режим только для чтения и отдельно защищённое удаление

• Структурированные результаты и ошибки MCP

• Никаких значений учётных данных в ответах инструментов

Related MCP server: filemanager-mcp-server

Установка

npm install -g @vielhuber/ftpmcp

Конфигурация

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

Передайте файл на сервер:

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

protocol принимает ftp, ftps и ftps-implicit. Предпочитайте FTPS, если сервер его поддерживает. Обычный FTP отправляет учётные данные и содержимое без шифрования транспорта.

root — это видимый удалённый корень для всех путей инструментов на этом хосте. Настройте саму учётную запись FTP с эквивалентным серверным chroot: FTP не может надёжно предотвратить указание предоставленной сервером символьной ссылки за пределы чисто клиентской границы пути.

local_root ограничивает локальные загрузки и скачивания. Принимаются как относительные пути, так и абсолютные пути ниже этого каталога.

read_only: true блокирует загрузки, создание каталогов, переименования и удаление. Для удаления дополнительно требуется allow_delete: true.

Каждая операция, кроме list_hosts, требует выбранный псевдоним host.

Клиент MCP

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

Инструменты

Разработка

npm install
npm test
npm run format:check

Лицензия

MIT