비고
일부 정보는 상업적으로 출시되기 전에 실질적으로 수정될 수 있는 미리 출시된 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
Windows 파일 탐색기 MCP 연결 도구는 Model Context Protocol (MCP) 서버를 사용하여 파일에 액세스하고 수정할 수 있는 도구 집합을 제공합니다. 이 커넥터는 디바이스의 공용 폴더뿐만 아니라 문서, 데스크톱, 다운로드, 음악, 비디오 및 그림을 포함한 일반적인 사용자 폴더에 대한 액세스를 제공합니다. MCP의 강력한 기능 중 하나는 에이전트가 MCP 서버가 제공하는 도구와 각 도구의 입력 및 출력 매개 변수를 동적으로 발견할 수 있다는 점입니다. 따라서 커넥터 앱에 특정 도구에 대한 호출을 하드 코드할 필요가 없습니다.
파일 탐색기 MPC 연결 도구 및 매개 변수는 제공 할 수있는 도구 MCP 의 종류를 설명하기 위해 아래에 나와 있습니다.
Permissions
중요합니다
파일 액세스에는 명시적 사용자 권한이 필요합니다. 사용자 및 관리자는 파일에 대한 액세스를 거부할 수 있습니다.
파일 도구
| 도구 이름 | 입력 | 출력 | Notes |
|---|---|---|---|
| get_file_details // 파일 세부정보 가져오기 |
path (문자열) |
extension(string/null), size (integer), creationTime, , lastAccessTimelastWriteTime |
입력은 단일 파일 경로입니다. 출력은 메타데이터만 제공하며 파일 콘텐츠는 제공하지 않습니다. 읽기 전용 작업입니다. |
| create_directory |
path (string), directoryName (string) |
result (문자열) |
새 디렉터리를 만듭니다. 파일 시스템을 변경하기 때문에 파괴적인 작업입니다. |
| move_file |
oldFullPath (문자열), newFullPath (문자열) |
result (문자열) |
파일을 이동하거나 이름을 바꿉니다. 는 파일 위치를 변경하므로 파괴적입니다. |
| create_text_file |
path (string), filename (string), content (string) |
result (문자열) |
선택적 콘텐츠가 있는 텍스트 파일을 만듭니다. 파괴적 연산. |
| read_file |
filePath (문자열) |
contents (array), _meta (object/null) |
파일 콘텐츠를 리소스로 읽습니다. 읽기 전용 작업입니다. |
| get_directories |
path (문자열) |
result (path를 포함하는 개체의 배열) |
지정된 경로 내의 디렉터리를 나열합니다. 읽기 전용 작업입니다. |
| unzip_folder |
zipPath (string), extractPath (string) |
path (string/null) |
zip 파일을 폴더로 압축 해제합니다. 파일을 쓰기 때문에 파괴적입니다. |
| zip_folder |
folderPath (string), zipName (string) |
path (string/null) |
폴더를 zip 파일로 압축합니다. 이 과정은 새로운 파일이 생성되기 때문에 파괴적입니다. |
| read_text_file |
filePath (문자열) |
result (문자열) |
파일에서 텍스트 콘텐츠를 읽습니다. 는 Office 및 PDF 형식을 지원합니다. 읽기 전용입니다. |
| 텍스트 파일 편집 |
filePath (string), oldText (string), newText (string) |
result (문자열) |
이전 텍스트를 새 텍스트로 바꿔 파일의 텍스트를 편집합니다. 파괴적 연산. |
| 파일_검색 |
startingDir(string), searchPatterns (string), 선택적 필터(예: specifiedFileTypes, ) startDateendDate |
result(name, path, dateCreated, snippet) 속성을 포함한 객체의 배열 |
이름, 확장명, 날짜 범위별로 파일을 검색합니다. 는 텍스트 기반 파일에 대한 코드 조각을 반환할 수 있습니다. 코필로트+ PC에서는 자연어를 사용한 의미 체계 파일 검색을 포함할 수 있습니다. |