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.

FTP 액세스를 위한 MCP 서버

이 모델 컨텍스트 프로토콜(MCP) 서버는 FTP 서버와 상호 작용하는 도구를 제공합니다. Claude.app은 FTP 서버에서 디렉터리를 나열하고, 파일을 다운로드 및 업로드하고, 디렉터리를 생성하고, 파일/디렉토리를 삭제할 수 있습니다.

특징

  • 디렉토리 내용 나열 : FTP 서버의 파일 및 폴더 보기
  • 파일 다운로드 : FTP 서버에서 파일 콘텐츠 검색
  • 파일 업로드 : 새 파일을 만들거나 기존 파일을 업데이트합니다.
  • 디렉토리 생성 : FTP 서버에 새 폴더 만들기
  • 파일/디렉토리 삭제 : 파일이나 디렉토리를 제거합니다.

설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop에 mcp-server-ftp를 자동으로 설치하려면:

지엑스피1

필수 조건

  • Node.js 16 이상
  • 데스크톱용 Claude(또는 다른 MCP 호환 클라이언트)

소스에서 빌드

리눅스/맥OS

# 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

윈도우

# 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

build-windows.bat 스크립트는 Windows 시스템에서 종속성 설치 및 빌드를 처리하며, TypeScript 컴파일러에 문제가 있는 경우 대체 옵션을 제공합니다.

구성

Claude for Desktop과 함께 이 서버를 사용하려면 구성 파일에 다음을 추가하세요.

맥OS/리눅스

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

윈도우

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

Windows 빌드 문제 해결

Windows에서 빌드 문제가 발생하는 경우:

  1. 일반적인 빌드 문제를 처리하는 제공된 build-windows.bat 스크립트를 사용하세요.
  2. Node.js와 npm이 제대로 설치되었는지 확인하세요.
  3. TypeScript 컴파일러를 직접 실행해보세요: npx tsc
  4. 여전히 문제가 있는 경우 다음을 실행하여 build 디렉토리에 있는 미리 컴파일된 파일을 사용할 수 있습니다.
    node path\to\mcp-server-ftp\build\index.js

구성 옵션

환경 변수설명기본
FTP_HOSTFTP 서버 호스트 이름 또는 IP 주소로컬호스트
FTP_PORTFTP 서버 포트21
FTP_USERFTP 사용자 이름익명의
FTP_PASSWORDFTP 비밀번호(빈 문자열)
FTP_SECURE보안 FTP(FTPS)를 사용하세요거짓

용법

Claude for Desktop을 구성하고 다시 시작한 후에는 자연어를 사용하여 FTP 작업을 수행할 수 있습니다.

  • "내 FTP 서버의 /public 디렉토리에 있는 파일을 나열하세요"
  • "FTP 서버에서 /data/report.txt 파일을 다운로드하세요"
  • "이 텍스트를 notes.txt라는 파일로 FTP 서버에 업로드하세요"
  • "FTP 서버에 'backups'라는 새 디렉토리를 만듭니다."
  • "FTP 서버에서 obsolete.txt 파일을 삭제합니다."
  • "FTP 서버에서 빈 디렉토리 /old-project를 제거합니다."

사용 가능한 도구

도구 이름설명
list-directoryFTP 디렉토리의 내용 나열
download-fileFTP 서버에서 파일 다운로드
upload-fileFTP 서버에 파일 업로드
create-directoryFTP 서버에 새 디렉토리를 만듭니다.
delete-fileFTP 서버에서 파일 삭제
delete-directoryFTP 서버에서 디렉토리 삭제

보안 고려 사항

  • FTP 자격 증명은 Claude 구성 파일에 저장됩니다. 이 파일에 적절한 권한이 있는지 확인하세요.
  • 서버에서 지원하는 경우 FTP_SECURE=true 설정하여 FTPS(보안 FTP)를 사용하는 것을 고려하세요.
  • 서버는 업로드 및 다운로드를 위한 임시 파일을 시스템의 임시 디렉토리에 생성합니다.

특허

MIT

You must be authenticated.

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

Claude가 자연어 명령을 통해 FTP 서버와 상호 작용할 수 있도록 하여 사용자가 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