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
윈도우
build-windows.bat
스크립트는 Windows 시스템에서 종속성 설치 및 빌드를 처리하며, TypeScript 컴파일러에 문제가 있는 경우 대체 옵션을 제공합니다.
구성
Claude for Desktop과 함께 이 서버를 사용하려면 구성 파일에 다음을 추가하세요.
맥OS/리눅스
~/Library/Application Support/Claude/claude_desktop_config.json
편집합니다.
윈도우
%APPDATA%\Claude\claude_desktop_config.json
편집합니다.
Windows 빌드 문제 해결
Windows에서 빌드 문제가 발생하는 경우:
- 일반적인 빌드 문제를 처리하는 제공된
build-windows.bat
스크립트를 사용하세요. - Node.js와 npm이 제대로 설치되었는지 확인하세요.
- TypeScript 컴파일러를 직접 실행해보세요:
npx tsc
- 여전히 문제가 있는 경우 다음을 실행하여
build
디렉토리에 있는 미리 컴파일된 파일을 사용할 수 있습니다.Copy
구성 옵션
환경 변수 | 설명 | 기본 |
---|---|---|
FTP_HOST | FTP 서버 호스트 이름 또는 IP 주소 | 로컬호스트 |
FTP_PORT | FTP 서버 포트 | 21 |
FTP_USER | FTP 사용자 이름 | 익명의 |
FTP_PASSWORD | FTP 비밀번호 | (빈 문자열) |
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-directory | FTP 디렉토리의 내용 나열 |
download-file | FTP 서버에서 파일 다운로드 |
upload-file | FTP 서버에 파일 업로드 |
create-directory | FTP 서버에 새 디렉토리를 만듭니다. |
delete-file | FTP 서버에서 파일 삭제 |
delete-directory | FTP 서버에서 디렉토리 삭제 |
보안 고려 사항
- FTP 자격 증명은 Claude 구성 파일에 저장됩니다. 이 파일에 적절한 권한이 있는지 확인하세요.
- 서버에서 지원하는 경우
FTP_SECURE=true
설정하여 FTPS(보안 FTP)를 사용하는 것을 고려하세요. - 서버는 업로드 및 다운로드를 위한 임시 파일을 시스템의 임시 디렉토리에 생성합니다.
특허
MIT
You must be authenticated.
Claude가 자연어 명령을 통해 FTP 서버와 상호 작용할 수 있도록 하여 사용자가 FTP 서버에서 디렉토리를 나열하고, 파일을 다운로드/업로드하고, 디렉토리를 만들고, 파일/디렉토리를 삭제할 수 있도록 합니다.