NAVER MYBOX

naver-mybox-mcp

一个适用于 NAVER MYBOX（네이버 마이박스）的 MCP 服务——通过任意 MCP 客户端（Claude Code、Claude Desktop 等）列出、搜索、下载和上传 MYBOX 云盘中的文件。

MYBOX 于 2026 年 8 月开放了公共 API（developers.mybox.naver.com）。 本项目将其封装为工具。此项目为非官方项目，与 NAVER 无关联。

为什么要用

手机照片会自动存入 MYBOX。要将它们放到电脑上，过去只能通过网页界面逐个点击。使用本项目后，Agent 可以一步将“9 月 10 日至 11 日拍摄的所有照片”下载到工作目录。

安装

需要 Python 3.10+。

pip install naver-mybox-mcp

获取令牌

身份验证使用的是个人访问令牌，而非 OAuth。

1. 在网页上登录 MYBOX。
2. 进入“设置” → 账号及个人访问令牌管理 → 创建令牌。
3. 立即复制——令牌只会显示一次。

每个账号最多可创建五个令牌；每个令牌的有效期为 30、60、90 或 180 天。MYBOX 会在令牌到期前 7 天和 1 天发送电子邮件提醒。任何持有令牌的人都可以访问整个云盘，因此请像对待密码一样妥善保管，切勿将其提交到代码库。

将令牌设为 MYBOX_PAT 环境变量，或将其单独写入 ~/.mybox/token 文件。

配置 MCP 客户端

{
  "mcpServers": {
    "mybox": {
      "command": "naver-mybox-mcp",
      "env": { "MYBOX_PAT": "mbx_pat_..." }
    }
  }
}

在 Claude Code 中：claude mcp add mybox --env MYBOX_PAT=mbx_pat_... -- naver-mybox-mcp

工具

工具	功能
mybox_storage	配额、已用字节数、各类别文件数量、最大上传大小
mybox_list	列出文件夹内的条目，或列出云盘根目录
mybox_search	按关键词、类别和／或日期范围（KST）搜索
mybox_file_info	获取单个文件或文件夹的属性
mybox_download	将单个文件下载到本地目录
mybox_upload	上传单个本地文件
mybox_create_folder	创建文件夹

刻意不提供：删除

该 API 可以删除文件、清空回收站并设置自动删除期限。本项目不会开放这些工具。能够读写文件的 Agent 很有用；能够销毁文件的 Agent 则是另一种风险，而且网页界面就在眼前。如果需要这些功能并希望通过标志启用，请提交 issue。

配额

文档公布了各套餐的限制，并警告称，突发请求或滥用可能会在不事先通知的情况下遭到拦截，因此客户端会将请求频率控制在文档所述最低每分钟限制以下（搜索为 9 次／分钟，其他操作为 55 次／分钟）。免费账号也可以使用 API；套餐只会影响限制。

套餐	下载	搜索	其他 API
30GB	500 次／天	10 次／分钟	每项 60 次／分钟
80GB	1,000 次／天	10 次／分钟	每项 60 次／分钟
180GB–330GB	1,000 次／天	30 次／分钟	每项 240 次／分钟
2TB	2,000 次／天	30 次／分钟	每项 240 次／分钟

**下载限制按天计算，客户端无法通过控制请求频率来规避。**请先搜索并统计结果数量；如果结果较多，请分批获取。

API 说明

• 基础 URL：https://open-api.mybox.naver.com/v1
• 上传分两步进行：POST /drive/files 会返回一个 uploadUrl（有效期 48 小时，仅可使用一次）；文件字节通过 multipart 字段 Filedata 上传。
• 下载分两步进行：GET /drive/files/{id}/download 会返回一个 downloadUrl（有效期 10 分钟，仅可使用一次）。
• 分页：将 responseMetaData.nextCursor 作为 cursor 传回。
• 搜索至少需要指定关键词、类别或日期范围之一。
• API 不会公开加密文件夹和与你共享的文件夹——这些内容只能通过网页和移动应用访问。列表为空并不代表云盘为空。

相关项目

MYBOX API 于 2026-08-10 开放，相关工具也很快出现。NAVER 没有发布自己的 MCP 服务或 SDK，发布公告中也没有提及 MCP。现有的社区项目包括：

项目	简介
minking/mybox-mcp	使用 TypeScript 编写的 MCP 服务，涵盖全部 20 个端点，包括删除和回收站功能
oliverne/myboxctl	用于文件操作的命令行工具（在 npm 上名为 @oliverne/myboxctl）
overworks/php-mybox	PHP SDK，以及同一作者编写的 Go 命令行工具和 Flysystem 适配器
chiwanpark/mybox-s3	位于 MYBOX 前端、兼容 S3 的 API

本项目使用 Python 编写，提供的功能范围经过有意精简（不包含删除），会遵守文档中说明的速率限制，并附带无需令牌或网络的测试。请选择最适合你的项目；如果需要包含破坏性操作在内的所有端点，上面的 TypeScript 服务已提供这些功能。

开发

pip install -e ".[dev]"
pytest

测试使用 httpx.MockTransport 运行，无需令牌或网络。

发布版本时，会通过 GitHub Actions 从 GitHub release 发布到 PyPI（使用 Trusted Publishing，无需存储令牌），并通过 GitHub OIDC 发布到 MCP registry。

许可证

MIT