Filesystem

Edge Tunnel로 연결된 로컬 파일 시스템에서 파일과 디렉터리를 조회, 생성, 수정, 이동할 수 있습니다.

주요 기능

• 파일 읽기 및 여러 파일 동시 조회
• 파일 생성, 덮어쓰기, 라인 기반 수정
• 디렉터리 생성 및 목록/트리 조회
• 파일 및 디렉터리 이동
• 파일 검색 및 메타데이터 확인

기본 정보

인증 방식

별도의 인증이 필요하지 않습니다.

지원 범위

Edge Tunnel을 통해 접근 가능한 허용 디렉터리 안에서만 동작합니다.

지원하는 MCP 도구

파일 조회 도구

read_file

단일 파일의 전체 내용 또는 앞/뒤 일부 라인을 읽습니다.

read_multiple_files

여러 파일의 내용을 한 번에 읽습니다.

get_file_info

파일 또는 디렉터리의 크기, 생성/수정 시간, 권한 등 메타데이터를 조회합니다.

파일 변경 도구

write_file

새 파일을 생성하거나 기존 파일 내용을 완전히 덮어씁니다.

edit_file

정확히 일치하는 텍스트를 찾아 라인 기반으로 수정하고 diff를 반환합니다.

move_file

파일 또는 디렉터리를 이동하거나 이름을 변경합니다.

디렉터리 도구

create_directory

새 디렉터리를 생성합니다. 중첩 디렉터리도 한 번에 생성할 수 있습니다.

list_directory

지정한 경로의 파일과 디렉터리 목록을 조회합니다.

list_directory_with_sizes

지정한 경로의 목록을 크기 정보와 함께 조회합니다.

directory_tree

지정한 경로의 디렉터리 트리를 JSON 구조로 조회합니다.

search_files

지정한 경로 아래에서 이름 패턴과 일치하는 파일 또는 디렉터리를 검색합니다.

사용 예시

예를 들어,

• Prompt로 “프로젝트 폴더에서 README 파일을 찾아 내용을 요약해줘”라고 입력하면,
• LLM은 MCP를 통해 search_files와 read_file 도구를 호출하여 파일을 찾고 내용을 읽습니다.
• 그리고, Tool 호출 결과를 기반으로 채팅에서 응답합니다.

주의사항

• 허용 디렉터리 밖의 경로에는 접근할 수 없습니다.
• write_file, edit_file, move_file은 파일 내용을 변경할 수 있으므로 요청 내용을 확인한 뒤 사용하세요.
• Edge Tunnel 연결 상태와 로컬 파일 권한에 따라 작업이 제한될 수 있습니다.