Microsoft SharePoint 和 OneDrive MCP Server 参考

概述

可用工具

CreateFolder

将指定文档库中的新文件夹创建为指定父文件夹的子文件夹。 如果未指定文档库，服务器将使用用户的 OneDrive。 如果未指定父文件夹，服务器将在根目录中创建该文件夹。 如果文件夹已存在同名，服务器会创建带有数字后缀的新文件夹，例如 NewFolder (1)。

必需参数

• folderName（string） - 要创建的文件夹的名称。 如果已存在同名的文件夹，服务器会将数字后缀添加到新文件夹名称，例如 NewFolder (1)。
• documentLibraryId（string） – 要在其中创建文件夹的文档库（也称为驱动器）的 ID。 如果要在用户的驱动器或其 OneDrive 中创建文件夹，例如“我的驱动器”或“我的 onedrive”，请以该documentLibraryId文件夹的形式发送"me"。

可选参数：

• parentFolderId（string， default = “root”） - 将在其中创建新文件夹的父文件夹的 ID。 如果未指定，则默认为文档库的根目录。

findSite

查找用户可以访问的 SharePoint 网站。 此工具可以根据你提供的搜索查询查找特定网站，或者如果未提供搜索查询，则查找用户可访问的前 20 个相关网站。

必需参数

无

可选参数：

• searchQuery（string， default = null） - 可以是整个或部分网站名称的搜索查询。 提供搜索查询有助于有效地搜索网站，但前提是用户正在寻找特定网站。 例如，如果用户请求一个调用xyz的网站，你会作为searchQuery该站点传递xyz。 如果用户只是要求“我的网站”，请将此参数留空。

listDocumentLibrariesInSite

列出指定 SharePoint 网站中的文档库（也称为驱动器）。 如果未指定站点，服务器将使用根站点。

必需参数

无

可选参数：

• siteId： 站点 ID（默认值：root）

findFileOrFolder

通过传递搜索查询查找用户可访问的文件或文件夹（也称为 DriveItem）。

必需参数

• searchQuery： 可以是整个或部分文件名的搜索查询

renameFileOrFolder

在指定的文档库中重命名文件或文件夹（也称为 DriveItems）。 注意：新名称必须符合命名约定。

必需参数

• documentLibraryId： 文档库 ID （字符串）
• fileOrFolderId： 文件或文件夹 ID （字符串）
• newFileOrFolderName： 文件或文件夹 的新名称（字符串）

deleteFileOrFolder

从指定的文档库中删除文件或文件夹。

必需参数

• documentLibraryId： 文档库 ID （字符串）
• fileOrFolderId： 文件或文件夹 ID （字符串）

readSmallTextFile

从特定文档库读取（下载）文本文件。 如果未指定文档库，则使用用户的 OneDrive。 需要提供 fileId（File 的 driveItemId）来标识和下载该文件。

必需参数

• fileId（string）
• documentLibraryId（string） - 要读取的文件的文档库（也称为驱动器）的 ID。 如果用户要求你在驱动器或 Onedrive 中读取或下载文件（ 例如 - 在“我的驱动器”中读取文件，请在“我的 onedrive”中读取文件，应以 documentLibraryId 的形式在“me”中发送文件。

moveSmallFile

将位于指定文档库中的文件移动到另一个文件夹。 此工具仅支持对小于 5 MB 的文件进行移动，并且支持在同一站点中移动。 不能使用此请求在驱动器之间移动文件。

必需参数

• documentLibraryId（string） - 要移动的文件的文档库（也称为驱动器）的 ID。 如果用户要求你在驱动器或 Onedrive 中移动文件 （例如 - 在“我的驱动器”中移动文件），请在“我的 onedrive”中移动文件，应以 documentLibraryId 的形式在“me”中发送文件。
• fileId（string） - 要移动的文件的 ID
• newParentFolderId（string） - 要将文件移动到的目标文件夹的 ID。 应与文件的原始位置位于同一文档库中。

getFileOrFolderMetadata

从 Sharepoint 网站中的指定文档库获取文件或文件夹的元数据。

必需参数

• FileOrFolderId（string） – 文件或文件夹的 ID。 它们也称为 DriveItems。 其 ID 有时也称为 driveItemId。
• documentLibraryId（string） - 需要其元数据的文件或文件夹的文档库（也称为驱动器）的 ID。 如果用户要求你在其驱动器或 Onedrive 中获取文件或文件夹，例如 -“获取驱动器中文件的元数据”或“获取 onedrive 中文件夹的元数据”，则应以 documentLibraryId 的形式以“me”形式发送。

createSmallTextFile

创建或将小于 5 MB 的文本文件上传到特定文档库。 如果未指定文档库，则使用用户的 OneDrive。 可上传特定文件： 如果未指定文件夹，文件将上传到根文件夹。

必需参数

• filename （string） - 要创建的文件的名称
• contentText （字符串） - 要创建的文件的文本内容
• documentLibraryId （string） - 文件的文档库（也称为驱动器）的 ID。 如果用户要求你在驱动器或 OneDrive 中创建文件，例如“在我的驱动器中创建文件”或“在我的 onedrive 中创建文件”，请发送“me”作为 documentLibraryId。

可选参数：

• parentfolderId（string， default = “root”） - 驱动器中的文件夹 ID 以添加新文件。

getFileOrFolderMetadataByUrl

从共享 URL 获取文件或文件夹的元数据。 只有具有显式权限访问文件的用户才能获取元数据。

必需参数

• fileOrFolderUrl：（string） - 文件或文件夹的 URL（也称为 DriveItems）。 该 URL 未兑换以与用户共享;它们必须已具有对文件的显式访问权限。

shareFileOrFolder

发送共享邀请，以授予对指定文档库中的文件或文件夹的权限。 支持分配角色并通知收件人。

必需参数

• documentLibraryId： 文档库 ID （字符串，必需）
• fileOrFolderId： 文件或文件夹 ID （字符串，必需）
• recipientEmails：（string[]，必需） - 要邀请的收件人的电子邮件地址。 至少需要一封收件人电子邮件。

可选参数：

• roles（string[]） - 要分配给收件人的角色。 接受的值：读取、写入（写入授予读取和写入访问权限）。 如果未指定，则 默认为 10000。
• sendInvitation（bool， default = true） – 指示是否发送共享邀请。 如果未指定，则 默认为 10000。
• message（string， default = “我们正在协作处理的文件。”） – 自定义邮件以包含在邀请电子邮件中。 如果未指定，则默认为标准消息。

getFolderChildren

枚举文档库中指定父文件夹中的前 20 个文件和文件夹。 如果未指定文档库，则使用用户的 OneDrive。

必需参数

• documentLibraryId（string） - 父文件夹的文档库（也称为驱动器）的 ID。 如果用户要求获取其驱动器或其 OneDrive 中的文件夹中的文件，例如“获取驱动器中的文件夹中的文件”或“获取 onedrive 中某个文件夹中的文件”，请发送“me”作为 documentLibraryId。

可选参数：

• parentFolderId：（string， default = “root”） - 列出文件和文件夹的父文件夹（DriveItem）的 ID。 如果未指定，则默认为文档库的根文件夹。

回显

客户端向服务器发送消息

必需参数

• 消息： 要发送回的消息

setSensitivityLabelOnFile

从指定的文档库设置文件的敏感度标签。

必需参数

• documentLibraryId（string） - 文档库 ID（也称为 driveId）文档库
• fileId（string） - 文件的文件 ID（也称为 driveItemId）
• sensitivityLabelId（string） - 必需。 要分配的敏感度标签的 ID，或删除敏感度标签的空字符串。

可选参数：

• assignmentMethod（string， default = “privileged”） - 文档上标签的赋值方法。 指示标签的分配是自动完成、标准还是作为特权作（相当于管理员作）。 可能的值为标准值、特权值、自动值和 unknownFutureValue。
• justificationText（string， default = “Changed by MCPServer”） – 可选。 用于审核目的的理由文本，在降级或删除标签时是必需的。

getDefaultDocumentLibraryInSite

获取 SharePoint 网站中的默认文档库（也称为驱动器）。 如果未指定站点，则使用根站点。

必需参数

无

可选参数：

• siteId： 站点 ID（默认值：root）

主要功能

文件夹管理

• 创建具有自动命名冲突解决的文件夹
• 枚举文件夹子级 （前 20 个）
• 在文件夹之间移动文件（在同一站点中）

文件操作次数

• 创建和上传小型文本文件（< 5MB）
• 读取和下载文本文件
• 重命名或移动文件和文件夹
• 删除文件或文件夹
• 按 ID 或 URL 获取文件和文件夹元数据

网站和库发现

• 通过搜索查询查找 SharePoint 网站
• 列出网站中的文档库
• 获取默认文档库

共享和权限

• 使用角色分配共享文件和文件夹
• 使用自定义邮件发送共享邀请
• 通过显式权限进行访问控制

安全性与合规性

• 在文件上设置敏感度标签
• 支持特权、标准和自动分配方法
• 合规性审核的理由文本

集成

• OneDrive 和 SharePoint Online 支持
• 特定于租户的服务器连接
• 文件和文件夹的 DriveItem 抽象

注释

1. 默认文档库为“me”（用户的 OneDrive）
2. 默认父文件夹为“root”
3. 使用数字后缀解决的文件夹名称冲突
4. 文件移动限制为小于 5 MB 且在同一站点内
5. 共享 URL 需要显式访问权限
6. DriveItems 表示文件和文件夹
7. 文件夹子枚举的前 20 个限制