Partilhar via

Conector do Explorador MCP de Ficheiros 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 Ficheiros do Windows MCP fornece um conjunto de ferramentas para aceder e modificar ficheiros através de um servidor Model Context Protocol (MCP). Este conector fornece acesso a pastas comuns dos utilizadores, incluindo Documentos, Ambiente de Trabalho, Downloads, Música, Vídeos e Imagens, bem como pastas públicas no dispositivo. Uma característica 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 de cada ferramenta. Portanto, não há necessidade de codificar chamadas para uma ferramenta específica numa aplicação de conectores.

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

Permissions

Importante

O acesso a ficheiros requer permissão explícita do utilizador. Utilizadores e administradores podem negar o acesso a ficheiros.

Ferramentas de ficheiros

Nome da Ferramenta Entrada Output Notes
get_file_details path (cadeia de caracteres) extension (string/nulo), size (inteiro), creationTime, lastAccessTime, lastWriteTime A entrada é um caminho de ficheiro único; A saída fornece apenas metadados, sem conteúdo do ficheiro. Operação apenas de leitura.
create_directory path (cadeia de caracteres), directoryName (cadeia de caracteres) result (cadeia de caracteres) Cria um novo diretório; operação destrutiva porque altera o sistema de ficheiros.
move_file oldFullPath (string), newFullPath (string) result (cadeia de caracteres) Move ou renomeia um ficheiro; destrutivo porque altera a localização do ficheiro.
create_text_file path (string), filename (string), content (string) result (cadeia de caracteres) Cria um ficheiro de texto com conteúdo opcional; operação destrutiva.
read_file filePath (cadeia de caracteres) contents (matriz), _meta (objeto/nulo) Lê o conteúdo do ficheiro como um recurso; Operação apenas de leitura.
get_directories path (cadeia de caracteres) result (array de objetos com path) Lista diretórios dentro de um determinado caminho; Operação apenas de leitura.
unzip_folder zipPath (string), extractPath (string) path (string/null) Descomprime um ficheiro zip numa pasta; destrutivo porque escreve ficheiros.
zip_folder folderPath (string), zipName (string) path (string/null) Comprime uma pasta num ficheiro zip; destrutivo porque cria um novo ficheiro.
read_text_file - Função para ler um ficheiro de texto filePath (cadeia de caracteres) result (cadeia de caracteres) Lê conteúdo textual de um ficheiro; suporta formatos Office e PDF; Só leitura.
edit_text_file filePath (string), oldText (string), newText (string) result (cadeia de caracteres) Edita texto num ficheiro substituindo texto antigo por novo; operação destrutiva.
search_files startingDir (cadeia), searchPatterns (cadeia), filtros opcionais como specifiedFileTypes, startDate, endDate result (array de objetos com name, path, dateCreated, snippet) Pesquisa ficheiros por nome, extensão, intervalo de datas; pode devolver excertos para ficheiros baseados em texto. Nos PCs Copilot+, isto pode incluir pesquisa semântica de ficheiros usando linguagem natural.
  • Last updated on