SuperAPI AI 工具集

msgraph-visio

办公与效率

查看项目

更新于 10-15 17:21

技能介绍

用途:在 OneDrive/SharePoint 中发布(上传)Visio(.vsdx)及其他图表文件,或读取文件元数据与文件夹内容。本技能只移动文件,不打开、渲染或编辑 Visio 文档,也不做 Visio 转换。

主要能力(来自实时服务器验证的工具):upload-file-content 把文件字节写入驱动器路径;get-drive-item 获取单项元数据,用于判断是否会覆盖;list-folder-files 列出文件夹内容,确认目标存在;login / verify-login 设备码登录与会话状态。此表面刻意保留写能力,因此是本 M365 表面中会改变远程状态的一个;对系统记录(system of record)的写入需门控:上传前与操作者确认目标路径与文件名,覆盖已有项前先说明。只需读取时改用 msgraph-files。

使用方式:调用命令为 npx -y @softeria/ms-365-mcp-server --enabled-tools 'upload-file-content|drive-item|folder-files',包为 @softeria/ms-365-mcp-server(MIT),刻意不加 --read-only。需要 Entra ID 应用注册与委派 Files.ReadWrite 作用域。过滤器为强制项:不过滤时服务器暴露 188 个工具、约 225,355 tokens,是 5,000 token 上限的 45 倍,应尽量收窄过滤范围。环境变量:MS365_MCP_CLIENT_ID、MS365_MCP_TENANT_ID。

典型流程:verify-login(需要时 login,显示设备码,不伪造会话)→ list-folder-files 确认目标文件夹→ get-drive-item 检查目标文件名是否为覆盖,若是先确认→ upload-file-content 上传字节→ 报告返回的 item id 与路径,未获服务器响应不得声称成功。.vsdx 本身由文档生成或图表技能产出,本技能只发布磁盘上已存在的文件。

限制与诚实读取:上传成功仅确认传输,不说明图表是否正确;失败的 上传可能留下部分项,应重新用 get-drive-item 检查;此处没有重命名或删除(过滤器刻意排除),修正文件名需操作者在 Web UI 中处理。版本 2.0.0 替换了此前不存在的包;旧文档中的 graph_* 工具名在任何服务器中都不存在,本页工具名来自实时服务器。工具名与清单开销已测量,但尚未实际执行过上传,需要具备写作用域的 M365 租户,本环境不具备,写路径未经证实。可配合技能:msgraph-files(只读检查)、document-generation、drawio-diagram、uml-diagram(产出文件)、gait-session-tracking(记录上传路径、文件名、item id)。