baidudisk-mcp

# baidudisk-mcp

Use this skill to run Baidu Netdisk tools through `mcporter`.

## 1) Enable server in mcporter

Run:

```bash
bash scripts/baidudisk_mcporter.sh register
```

This writes a `baidudisk` stdio server entry into `config/mcporter.json` with:

- command: `/home/linuxbrew/.linuxbrew/bin/uv`
- args: `--directory <workspace>/skills/baidudisk-mcp/server run netdisk.py`
- env: `BAIDU_NETDISK_TOKEN_FILE=~/.openclaw/credentials/baidudisk.json`

Check status:

```bash
bash scripts/baidudisk_mcporter.sh check
mcporter --config /home/ubuntu/.openclaw/workspace/config/mcporter.json list baidudisk
```

## 2) Credential file and hot update

Credential file (local only):

`~/.openclaw/credentials/baidudisk.json`

Expected keys:

- `access_token` (required)
- `default_dir` (recommended)

Example (do not commit real token):

```json
{
  "access_token": "<redacted>",
  "default_dir": "/Openclaw/baidudisk"
}
```

The MCP server reads this file on **every tool call**.
So token rotation only needs editing this file; no server restart is required.

## 3) 2.0 tools

### 3.1 Official-aligned tools (主推)

四个基础列表接口与 MCP tool 对应关系：

- `/rest/2.0/xpan/file?method=list` → `file_list(dir?, limit?, order?, desc?, start?)`
- `/rest/2.0/xpan/file?method=imagelist` → `file_image_list(parent_path?, recursion?, page?, num?, order?, desc?, web=1)`
- `/rest/2.0/xpan/file?method=doclist` → `file_doc_list(parent_path?, recursion?, page?, num?, order?, desc?)`
- `/rest/2.0/xpan/file?method=videolist` → `file_video_list_api(parent_path?, recursion?, page?, num?, order?, desc?, web=1)`

另保留一个历史兼容视频工具（非官方 videolist 参数模型）：

- `file_video_list(dir?, recursion?, start?, limit?, order?, desc?)`（基于 `xpanfilelistall` 过滤视频）

其他工具：

- `category_info(category, parent_path='/', recursion=1)`
- `category_info_multi(categories, parent_path='/', recursion=1)`
- `image_gettags(type=1)`
- `image_gettags_summary(type=1, top=50)`
- `image_search(search_type, keyw...