Compartilhar via


Conector do Explorador de Arquivos MCP do Windows

Observação

Algumas informações estão relacionadas com o produto pré-lançado que pode ser substancialmente modificado antes de ser lançado comercialmente. A Microsoft não oferece garantias, expressas ou implícitas, em relação às informações fornecidas aqui.

O conector do Explorador de Arquivos MCP do Windows fornece um conjunto de ferramentas para acessar e modificar arquivos usando um Model Context Protocol servidor (MCP). Esse conector fornece acesso a pastas de usuário comuns, incluindo Documentos, Área de Trabalho, Downloads, Música, Vídeos e Imagens, bem como pastas públicas no dispositivo. Um recurso que MCP o torna tão poderoso é que os agentes podem descobrir dinamicamente as ferramentas que um MCP servidor fornece, bem como os parâmetros de entrada e saída para cada ferramenta. Portanto, não é necessário codificar manualmente chamadas para uma ferramenta específica em um aplicativo conector.

As ferramentas e parâmetros de conexão MPC do Explorador de Arquivos são mostrados abaixo para ilustrar os tipos de ferramentas que uma MCP ferramenta pode fornecer.

Permissions

Importante

O acesso ao arquivo requer permissão explícita do usuário. Usuários e administradores podem negar acesso a arquivos.

Ferramentas de arquivo

Nome da ferramenta Entrada Saída Notes
obter_detalhes_do_arquivo path (cadeia) extension(string/null), size (inteiro), creationTime, lastAccessTimelastWriteTime A entrada é um único caminho de arquivo; a saída fornece apenas metadados, sem conteúdo de arquivo. Operação somente leitura.
create_directory path (cadeia de caracteres), directoryName (cadeia de caracteres) result (cadeia) Cria um novo diretório; operação destrutiva porque altera o sistema de arquivos.
move_file oldFullPath (cadeia de caracteres), newFullPath (cadeia de caracteres) result (cadeia) Move ou renomeia um arquivo; destrutivo porque altera o local do arquivo.
create_text_file path (cadeia de caracteres), filename (cadeia de caracteres), content (cadeia de caracteres) result (cadeia) Cria um arquivo de texto com conteúdo opcional; operação destrutiva.
read_file filePath (cadeia) contents (matriz), _meta (objeto/nulo) Lê o conteúdo do arquivo como um recurso; operação somente leitura.
get_directories path (cadeia) result (matriz de objetos com path) Lista diretórios dentro de um determinado caminho; operação somente leitura.
unzip_folder zipPath (cadeia de caracteres), extractPath (cadeia de caracteres) path (string/nulo) Descompacta um arquivo zip em uma pasta; destrutivo porque grava arquivos.
zip_folder folderPath (cadeia de caracteres), zipName (cadeia de caracteres) path (cadeia de caracteres/nulo) Compacta uma pasta em um arquivo zip; destrutivo porque cria um novo arquivo.
read_text_file filePath (cadeia) result (cadeia) Lê o conteúdo de texto de um arquivo; dá suporte a formatos office e PDF; somente leitura.
editar_arquivo_de_texto filePath (cadeia de caracteres), oldText (cadeia de caracteres), newText (cadeia de caracteres) result (cadeia) Edita texto em um arquivo substituindo texto antigo por novo; operação destrutiva.
buscar_arquivos startingDir(cadeia de caracteres), searchPatterns (cadeia de caracteres), filtros opcionais comospecifiedFileTypes, , startDateendDate result(matriz de objetos com name, , , path) dateCreatedsnippet Pesquisa arquivos por nome, extensão, intervalo de datas; pode retornar snippets para arquivos baseados em texto. Em PCs Copilot+, isso pode incluir a pesquisa semântica de arquivos usando linguagem natural.