🗃️ftpmcp🗃️

FTP 및 FTPS 파일 작업을 위한 집중된 Model Context Protocol 서버입니다. 의도적으로 SFTP를 구현하지 않습니다. SSH 기반 전송은 여기서 자격 증명과 전송 로직을 중복하지 않고 SSH MCP에 속합니다.

기능

• 일반 FTP, 명시적 FTPS 및 암시적 FTPS

• 하나의 MCP 프로세스에서 원하는 수의 명명된 FTP 호스트

• 원격 작업은 각 호스트의 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