注释
某些信息与预发布产品有关，在商业发布之前，这些预发布产品可能会进行重大修改。 Microsoft对此处提供的信息不作任何明示或暗示的保证。
Windows 文件资源管理器 MCP 连接器提供了一组工具，用于使用 Model Context Protocol （MCP） 服务器访问和修改文件。 此连接器提供对常用用户文件夹（包括文档、桌面、下载、音乐、视频和图片）以及设备上的公用文件夹的访问权限。 MCP 的一个强大功能是代理可以动态发现 MCP 服务器提供的工具，以及每个工具的输入和输出参数。 因此，无需在连接器应用中对特定工具进行硬代码调用。
文件资源管理器 MPC 连接工具和参数如下所示，以展示MCP可以提供的工具类型。
Permissions
重要
文件访问需要显式用户权限。 用户和管理员可能会拒绝对文件的访问权限。
文件工具
| 工具名称 | 输入 | 输出 | 备注 |
|---|---|---|---|
| get_file_details |
path (字符串) |
extension（string/null）、（integer）、 sizecreationTime、、、 lastAccessTimelastWriteTime |
输入是单个文件路径;输出仅提供元数据，不提供文件内容。 只读操作。 |
| create_directory |
path （字符串）， directoryName （字符串） |
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 （字符串）， extractPath （字符串） |
path （string/null） |
将 zip 文件解压缩到文件夹中;破坏性，因为它写入文件。 |
| zip_folder |
folderPath(字符串)，zipName(字符串) |
path （string/null） |
将文件夹压缩为 zip 文件;破坏性，因为它会创建一个新文件。 |
| read_text_file |
filePath (字符串) |
result (字符串) |
从文件读取文本内容;支持 Office 和 PDF 格式;只读。 |
| edit_text_file |
filePath （string）、 oldText （string）、 newText （string） |
result (字符串) |
通过将旧文本替换为新文本来编辑文件中的文本，这是一个破坏性操作。 |
| search_files |
startingDir（string）、 searchPatterns （string）、可选筛选器，例如specifiedFileTypes， startDateendDate |
result（对象数组，，namepath， dateCreatedsnippet） |
按名称、扩展名、日期范围搜索文件;可以返回基于文本的文件的代码片段。 在 Copilot+ 电脑上，这可以包括使用自然语言的语义文件搜索。 |