内容
# mcp-pcloud
一款适用于 [pCloud](https://www.pcloud.com/) 云存储的 [模型上下文协议（MCP）](https://modelcontextprotocol.io/) 服务器。使像 Claude 这样的 AI 助手能够与您的 pCloud 交互 - 列出文件、创建文件夹、搜索、共享等。
## 安装
### 选项 1：通过 npm（推荐）
```bash
npx -y mcp-pcloud
```
或全局安装：
```bash
npm install -g mcp-pcloud
```
添加到 Claude 代码：
```bash
claude mcp add pcloud -e PCLOUD_USERNAME=you@example.com -e PCLOUD_PASSWORD=yourpassword -- npx -y mcp-pcloud
```
### 选项 2：从源代码
```bash
git clone https://github.com/fatherlinux/mcp-pcloud.git
cd mcp-pcloud
npm install
npm run build
```
添加到 Claude 代码：
```bash
claude mcp add pcloud -e PCLOUD_USERNAME=you@example.com -e PCLOUD_PASSWORD=yourpassword -- node /path/to/mcp-pcloud/dist/index.js
```
**适用于欧盟账户：** 在任一命令中添加 `-e PCLOUD_API_HOST=eapi.pcloud.com`。
## 身份验证
**选项 1：用户名/密码** （推荐 - 无需开发者门户）
```bash
export PCLOUD_USERNAME=your_email@example.com
export PCLOUD_PASSWORD=your_password
```
**选项 2：访问令牌** （需要 [开发者门户](https://docs.pcloud.com/my_apps/))
```bash
export PCLOUD_ACCESS_TOKEN=your_token
```
## 可用工具
| 工具 | 描述 |
|------|-------------|
| `pcloud_list_folder` | 列出文件夹内容 |
| `pcloud_create_folder` | 创建文件夹 |
| `pcloud_delete_folder` | 删除文件夹 |
| `pcloud_rename_folder` | 重命名/移动文件夹 |
| `pcloud_copy_folder` | 复制文件夹 |
| `pcloud_get_file_info` | 获取文件元数据 |
| `pcloud_delete_file` | 删除文件 |
| `pcloud_rename_file` | 重命名/移动文件 |
| `pcloud_copy_file` | 复制文件 |
| `pcloud_get_file_link` | 获取临时下载链接 |
| `pcloud_create_public_link` | 创建公共共享链接 |
| `pcloud_search` | 搜索文件和文件夹 |
| `pcloud_read_text_file` | 读取文本文件内容 |
| `pcloud_get_checksum` | 获取文件校验和 |
| `pcloud_get_user_info` | 获取账户信息和配额 |
## 示例用法
配置完成后，询问 Claude：
- "列出我的 pCloud 文件"
- "我使用了多少存储空间？"
- "在 pCloud 中搜索 PDF 文件"
- "创建一个名为 Backups 的文件夹"
## 许可证
GPL-3.0 - [fatherlinux](https://github.com/fatherlinux)
