OneDrive CLI

社区

OneDrive 的命令行界面与只读 MCP 服务器

分类: 云存储第 9 / 15
Stars: ★ 174 非常热门
传输方式: stdio（本地进程）
运行环境: Node.js · 预编译二进制
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 3 天前
工具数: 7

56FMRS · C

onedrive-cli 提供了一个跨平台的 OneDrive 个人版命令行接口，并附带一个只读 MCP 服务器，适合需要 AI 访问云文件（如文档、图片）的用户。它不支持 OneDrive for Business，并且是社区项目而非官方微软产品。使用前需注意令牌安全，并仅使用只读令牌以降低风险。

最强项 · 文档质量 13/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

12/20

维护活跃度

12/20

文档质量

13/20

安装易用性

11/20

查看各项评分依据

可靠性 8/20: 仓库包含src目录和测试，但未提供CI工作流文件或明确的测试运行命令，无法确认MCP握手和工具行为是否可复现。工具声明为只读，但README中的'rm'未实现可能导致工具列表与行为不一致。
安全与权限 12/20: 令牌存储在~/.onedrive-cli-token，未加密，但默认只读令牌（login -r）降低了风险。MCP服务器只发出GET请求，并明确声明只读。但未提供安全策略或漏洞报告渠道，令牌处理依赖用户操作。
维护活跃度 12/20: 项目有MIT许可证，有持续提交（通过stars和recent activity推断，但未提供具体日期）。README中有TODO和DONE列表，显示积极开发。但未看到版本发布标签或依赖更新记录。
文档质量 13/20: README提供了安装、用法、MCP配置示例和FAQ，但缺少详细的MCP工具参数和错误处理说明。未提供安全或故障排查的专门文档。
安装易用性 11/20: 提供了npm、nix和源码安装方式，MCP配置示例清晰，但需要用户手动获取OAuth令牌并保存，步骤较多。未提供CI或测试证据，因此无法确认安装流程在所有平台上的可靠性。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件访问网络

适合谁

需要 AI 访问 OneDrive 个人文件的用户
喜欢命令行工具集成的人群
对只读访问有严格要求的场景

不适合谁

需要写入或修改 OneDrive 环境的场景
OneDrive for Business 用户（尚未支持）
需要管理员审批或企业策略的管理场景

所需权限

需要 OAuth 访问令牌（建议只读范围）
读取文件内容、元数据和存储配额
不会修改或删除任何文件

风险与副作用

令牌可能被泄露，令牌文件路径（~/.onedrive-cli-token）需妥善保护
MCP 服务器仅发出 GET 请求，但底层访问令牌可能具有额外权限，确保只读令牌
上传功能尚未实现，但其他命令（如 cp）可以有写权限，注意使用 read-only 登录

安装接入

准备工作

运行环境：Node.js · 预编译二进制

登录 OneDrive：运行 onedrive login，按照提示完成 OAuth 授权（建议使用 login -r 获取只读令牌）。
在 MCP 客户端（如 Claude Desktop）配置文件中添加服务器配置，例如 claude_desktop_config.json 中的 mcpServers。
配置后，MCP 客户端会自动启动 onedrive mcp 进行通信。

claude_desktop_config.json

{
  "mcpServers": {
    "onedrive": {
      "command": "onedrive",
      "args": [
        "mcp"
      ]
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "onedrive": {
      "command": "onedrive",
      "args": [
        "mcp"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add onedrive -- onedrive mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

先运行 onedrive login 获取访问令牌，然后在 MCP 客户端中注册 onedrive 服务器；连接成功后，客户端工具列表中应出现 list_onedrive_folder、search_onedrive_content 等 7 个工具，可以让 AI 列出某个文件夹来验证连接。

常见排障

错误“Access token was not found; 'login' first.”：请先运行 `onedrive login` 并完成授权。
检查令牌是否过期（有效期为 1 小时），可重新登录。
如果 MCP 客户端无法连接，请确保 `onedrive` 命令在 PATH 中，并且已先完成登录。
确保配置文件 JSON 格式正确。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

列出我 OneDrive Public 文件夹里的内容
在整个 OneDrive 中全文搜索包含某个关键词的文件
读取我 OneDrive 中某个文本文件的内容
查看我的 OneDrive 存储空间使用情况

工具能力 7

list_onedrive_folder 只读

列出文件夹的直接子项

search_onedrive_content 只读

在整个驱动器中执行全文搜索

find_onedrive_files 只读

按名称通配符递归查找项目

list_onedrive_albums 只读

列出相册或相册中的项目

read_onedrive_file 只读

以文本形式读取文件内容

stat_onedrive_item 只读

返回项目的完整元数据

onedrive_storage 只读

报告可用驱动器的存储配额

使用场景

允许 AI 助手浏览和搜索您的 OneDrive 文件内容

读取文档、统计存储使用情况

列出相册和照片

递归查找文件

支持客户端

Claude Desktop

依据项目文档列出，未经本站实测。

详细介绍

onedrive-cli 是一个跨平台的命令行工具，用于管理 OneDrive（个人版）文件。它还提供了一个只读的 MCP 服务器（通过 stdio 运行），使 MCP 客户端（如 Claude）可以浏览和读取您的 OneDrive 内容。该 MCP 服务器仅发出 GET 请求，不会修改您的云端文件。