Filesystem
Edge Tunnel로 연결된 로컬 파일 시스템에서 파일과 디렉터리를 조회, 생성, 수정, 이동할 수 있습니다.
주요 기능
- 파일 읽기 및 여러 파일 동시 조회
- 파일 생성, 덮어쓰기, 라인 기반 수정
- 디렉터리 생성 및 목록/트리 조회
- 파일 및 디렉터리 이동
- 파일 검색 및 메타데이터 확인
기본 정보
인증 방식
별도의 인증이 필요하지 않습니다.
지원 범위
Edge Tunnel을 통해 접근 가능한 허용 디렉터리 안에서만 동작합니다.
지원하는 MCP 도구
파일 조회 도구
read_file
텍스트 파일의 전체 내용 또는 앞/뒤 일부 라인을 읽습니다. 바이너리 파일(pdf, docx, xlsx)은 download_file을 사용합니다.
download_file
pdf, docx, xlsx 파일을 가져와 읽기, 요약, 분석에 사용할 수 있습니다.
“이 PDF를 읽고 핵심 내용을 요약해줘”와 같은 요청이 가능하며, 파일당 최대 50MiB까지 지원합니다.
read_multiple_files
여러 파일의 내용을 한 번에 읽습니다.
get_file_info
파일 또는 디렉터리의 크기, 생성/수정 시간, 권한 등 메타데이터를 조회합니다.
파일 변경 도구
write_file
인라인 텍스트로 새 파일을 생성하거나 기존 텍스트 파일의 내용을 완전히 덮어씁니다.
upload_file
사용자가 채팅에서 작업을 요청하면, 연결된 로컬 PC 또는 마운트된 파일 서버의 바이너리 파일을 읽고 해당 파일을 기반으로 새 파일을 생성하여 사용자가 지정한 경로에 저장할 수 있습니다.
- XLSX, PDF, DOCX 바이너리 파일 저장을 지원합니다.
- 기존 파일 수정 및 덮어쓰기는 지원하지 않으며, 결과 파일은 항상 새 파일로 저장됩니다.
- 파일당 최대 크기는 50 MiB입니다.
edit_file
정확히 일치하는 텍스트를 찾아 라인 기반으로 수정하고 diff를 반환합니다.
move_file
파일 또는 디렉터리를 이동하거나 이름을 변경합니다.
디렉터리 도구
create_directory
새 디렉터리를 생성합니다. 중첩 디렉터리도 한 번에 생성할 수 있습니다.
list_directory
지정한 경로의 파일과 디렉터리 목록을 조회합니다.
list_directory_with_sizes
지정한 경로의 목록을 크기 정보와 함께 조회합니다.
directory_tree
지정한 경로의 디렉터리 트리를 JSON 구조로 조회합니다.
search_files
지정한 경로 아래에서 이름 패턴과 일치하는 파일 또는 디렉터리를 검색합니다.
사용 예시
- “프로젝트 폴더에서 README 파일을 찾아 내용을 요약해줘”라고 입력하면, search_files와 read_file 도구를 호출하여 파일을 찾고 내용을 읽습니다.
- download_file, upload_file 도구를 호출하여 로컬 PC의 XLSX 신청서 양식에 사용자가 제공한 정보를 반영하여 새 신청서 파일을 생성하고, 지정된 로컬 경로에 저장할 수 있습니다.
주의사항
- 허용 디렉터리 밖의 경로에는 접근할 수 없습니다.
write_file,edit_file,move_file은 파일 내용을 변경할 수 있으므로 요청 내용을 확인한 뒤 사용하세요.- Edge Tunnel 연결 상태와 로컬 파일 권한에 따라 작업이 제한될 수 있습니다.