内容
<div align="center">
<img src="assets/logo.png" width="128" alt="mcp-pcloud icon" />
**MCP 服务器，用于 pCloud — 管理回收站、文件恢复和版本历史。**
<a href="https://kud.io/projects/mcp-pcloud">官方网站</a> · <a href="https://kud.io/projects/mcp-pcloud/docs">文档</a>
</div>
## 功能特点
- **回收站管理** — 列出已删除的文件，并通过 ID 从 pCloud 回收站恢复它们。
- **文件版本恢复** — 浏览任意文件路径的版本历史，并将文件恢复到新位置的以前版本。
- **文件修订** — 列出文件的所有修订版本，并恢复到任意以前的状态。
- **文件夹和文件操作** — 列出、获取文件元数据、复制、移动、重命名、创建和删除文件和文件夹。
- **文件共享** — 与其他 pCloud 用户共享文件夹，接受或拒绝传入的共享请求，并删除活动共享。
- **公开链接** — 为文件和文件夹创建、列出和删除公开下载链接，支持可选的过期时间和下载限制。
## 安装
将服务器添加到您的 MCP 客户端配置中：
```json
{
"mcpServers": {
"mcp-pcloud": {
"command": "npx",
"args": ["-y", "@kud/mcp-pcloud"],
"env": {
"MCP_PCLOUD_TOKEN": "您的 pCloud 访问令牌"
}
}
}
}
```
身份验证通过环境变量解析。请设置以下任意一个：
- `MCP_PCLOUD_TOKEN` — pCloud 访问令牌（最简单）
- `MCP_PCLOUD_CLIENT_ID` + `MCP_PCLOUD_CLIENT_SECRET` — OAuth 凭证
## 使用
配置完成后，您的 AI 助手可以使用以下工具：
| 工具名称 | 描述 |
| --- | --- |
| `list_trash` | 列出 pCloud 回收站中的所有文件 |
| `restore_from_trash` | 通过文件 ID 从回收站恢复文件 |
| `list_rewind_events` | 列出文件路径的版本历史 |
| `restore_from_rewind` | 从文件版本历史中恢复文件到新路径 |
| `list_revisions` | 列出文件的所有修订版本 |
| `revert_revision` | 将文件恢复到以前的修订版本 |
| `get_user_info` | 获取账户信息：配额、邮箱和计划 |
| `list_folder` | 列出文件夹的内容 |
| `get_file_stat` | 获取文件或文件夹的元数据 |
| `create_folder` | 创建文件夹 |
| `copy_file` | 复制文件到新路径 |
| `move_file` | 移动文件到新路径 |
| `rename_file` | 重命名文件 |
| `delete_file` | 永久删除文件 |
| `delete_folder` | 递归删除文件夹及其所有内容 |
| `get_file_link` | 获取文件的下载 URL |
| `get_checksum` | 获取文件的 SHA256、SHA1 和 MD5 校验和 |
| `get_zip_link` | 获取文件或文件夹的 ZIP 压缩包下载 URL |
| `list_shares` | 列出所有活动的文件夹共享 |
| `share_folder` | 与其他 pCloud 用户共享文件夹 |
| `accept_share` | 接受传入的共享请求 |
| `decline_share` | 拒绝传入的共享请求 |
| `remove_share` | 删除活动共享 |
| `create_file_publink` | 为文件创建公开下载链接 |
| `create_folder_publink` | 为文件夹创建公开下载链接 |
| `list_publinks` | 列出所有活动公开链接 |
| `delete_publink` | 通过其代码删除公开链接 |
## 开发
```sh
git clone https://github.com/kud/mcp-pcloud.git
cd mcp-pcloud
npm install
npm run dev
```
| 脚本命令 | 用途 |
| --- | --- |
| `npm run dev` | 从源代码运行，使用 `tsx` |
| `npm run build` | 编译 TypeScript 到 `dist/` |
| `npm run typecheck` | 类型检查，不生成输出 |
| `npm test` | 运行测试套件，使用 Vitest |
| `npm run inspect` | 启动 MCP 检查器，针对已构建的服务器 |
---
📚 **完整文档 → [mcp-pcloud/docs](https://kud.io/projects/mcp-pcloud/docs)**
