npm package: 360-netdisk-mcp
Description: 360 AI 云盘 MCP
Author: 360-netdisk-mcp
Latest version: 0.1.6

# 360 AI 云盘 MCP

360 AI 云盘的 Model Context Protocol 接入服务，让 AI 模型能够通过 MCP 协议直接操作云盘，提供完整的云盘文件管理能力。

<div align="center">
</div>

## 📚 简介

本项目为 360 AI 云盘的 MCP（Model Context Protocol）服务实现，允许各类 AI 模型（如大语言模型）通过标准的 MCP 协议与 360 AI 云盘进行交互。通过这种方式，AI 模型可以帮助用户管理云盘文件，极大地提升了文件管理的智能化和便捷性。

## 📥 安装

```bash
# 全局安装
npm install -g 360-netdisk-mcp

# 或者通过 npx 直接使用
npx 360-netdisk-mcp
```

## 🔧 在 Cursor 中配置

在 `~/.cursor/mcp.json` 文件中添加以下配置，连接 360 AI 云盘 MCP 服务：

```json
{
  "mcpServers": {
    "360-netdisk-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "360-netdisk-mcp"
      ],
      "env": {
        "API_KEY": "yunpan_xxxxxxxxx",
        "clientId": "xxxxxxxxxxxx",
        "clientSecret": "xxxxxxxxxxxx"
      }
    }
  }
}
```

## 🔐 认证配置

使用 360 AI 云盘 MCP 服务需要以下认证信息：

- `API_KEY`：云盘 API 密钥，格式为 "yunpan_" 开头的字符串
- `clientId`：客户端 ID
- `clientSecret`：客户端密钥

您可以通过以下方式获取这些认证信息：
1. 在 [360 AI 云盘开放平台](https://qa-open.yunpan.360.cn/metro/) 注册开发者账号
2. 创建应用并获取应用凭证
3. 联系 360 云盘团队申请相关权限

### 360 AI 云盘开放平台优势

360 AI 云盘开放平台提供了多元化的产品能力和一站式文件服务：

- **账号一键关联**：无需重新注册账号，现有 AI 云盘账号一键关联，实现"多平台，一账号"的无缝登录体验
- **支持 MCP 协议接入**：支持 Stdio/SSH/Streamable HTTP 协议，通过 MCP Client 轻松接入
- **丰富接口能力**：提供文件上传、下载、搜索、创建、删除、重命名等 API，满足不同场景需求

访问 [360 AI 云盘开放平台官网](https://qa-open.yunpan.360.cn/metro/) 获取更多详细信息和最新的开发文档。

## ✨ 功能概览

本 MCP 服务提供与 360 云盘交互的多种操作，包括：

- 📁 文件列表浏览 - 查看云盘目录内容
- 🔍 文件搜索 - 根据关键词搜索云盘文件
- ⬆️ 文件上传 - 将文件上传至 360 云盘
- 📂 目录创建 - 在云盘中创建新文件夹
- ✏️ 文件重命名 - 修改云盘文件或文件夹名称
- 🚚 文件移动 - 将文件移动到其他位置
- 🗑️ 文件删除 - 删除云盘中的文件或文件夹

## 🛠️ 工具使用指南

当连接到 360 AI 云盘 MCP 服务后，可以使用以下工具与云盘交互：

### 文件列表查询 (file-list)

获取 360 云盘指定路径下的文件和文件夹列表。

**参数：**
- `path`: 要查询的路径，默认为根目录 `/`
- `page`: 页码，默认为 0
- `page_size`: 每页显示条数，默认为 100

**示例：**
```json
{
  "path": "/文档",
  "page": 1,
  "page_size": 20
}
```

### 文件搜索 (file-search)

根据关键词搜索 360 云盘文件。

**参数：**
- `key`: 搜索关键词（必填）
- `file_category`: 文件类型（-1:全部，0:其他，1:图片，2:文档，3:音乐，4:视频），默认为 -1
- `page`: 页码，默认为 1
- `page_size`: 每页显示条数，默认为 20

**示例：**
```json
{
  "key": "报告",
  "file_category": 2,
  "page": 1
}
```

### 文件上传 (upload-file)

将本地文件上传到 360 云盘指定路径。

**参数：**
- `filePaths`: 本地文件的完整路径（必填，可以是字符串数组包含多个文件）
- `uploadPath`: 上传到云盘的目标目录，默认为根目录 `/`

**示例：**
```json
{
  "filePaths": ["/Users/username/Documents/报告.docx", "/Users/username/Documents/数据.xlsx"],
  "uploadPath": "/工作文件"
}
```

**单文件上传示例：**
```json
{
  "filePaths": "/Users/username/Desktop/测试文档.pdf",
  "uploadPath": "/文档"
}
```

### 创建文件夹 (make-dir)

在 360 云盘中创建新文件夹。

**参数：**
- `fname`: 文件夹路径，例如：`/新文件夹/`（必填）

**示例：**
```json
{
  "fname": "/工作文件/项目A/"
}
```

### 删除文件或文件夹 (file-del)

删除 360 云盘中的文件或文件夹。

**参数：**
- `fname`: 要删除的文件路径，多个文件路径用竖线(|)隔开（必填）

**示例：**
```json
{
  "fname": "/文档/旧文件.txt|/临时文件夹/"
}
```

### 移动文件 (file-move)

移动 360 云盘中的文件或文件夹到新位置。

**参数：**
- `src_name`: 文件原路径，多个路径用竖线隔开（必填）
- `new_name`: 目标路径（必填）

**示例：**
```json
{
  "src_name": "/文档/报告.docx|/文档/数据.xlsx",
  "new_name": "/归档文件夹/"
}
```

### 重命名文件 (file-rename)

重命名 360 云盘中的文件或文件夹。

**参数：**
- `src_name`: 原路径名称，如：`/文件夹/旧文件名.txt`（必填）
- `new_name`: 新名称，如：`新文件名.txt`（必填）

**示例：**
```json
{
  "src_name": "/文档/草稿.docx",
  "new_name": "最终报告.docx"
}
```

## 🧠 AI 应用场景

通过 360 AI 云盘 MCP 接入，AI 可以帮助用户实现以下场景：

- **智能文件整理**：AI 可以分析用户文件内容，并自动归类整理
- **文档智能检索**：使用自然语言描述查找云盘内的文档
- **自动文件备份**：根据用户习惯，提供智能备份建议
- **文件内容分析**：分析文档内容并提供摘要或见解
- **基于对话的文件操作**：用户可以通过对话方式管理云盘文件

## 🔑 关键词

- 360 AI 云盘
- mcp
- modelcontextprotocol
- ai助手
- 文件管理

## 📄 许可证

Apache-2.0