# FetchPan MCP 服务器：让 AI 助手下载网盘和文件站的文件

> FetchPan 的 MCP 服务器让 AI 助手直接检查链接、打开网盘分享、拿到下载直链。下面有接入方式，也可以在线调用试一试。

- 服务器地址: https://fetchpan.com/mcp
- 传输方式: Streamable HTTP（无状态，直接返回 JSON）
- 认证: 可选：Authorization: Bearer fp_…（令牌在开发者页创建）
- 不用令牌: 能连接、查看工具、检查链接，并下载前几个免费文件
- 网页版: https://fetchpan.com/zh/mcp-server
- JSON 服务说明: https://fetchpan.com/mcp-server.json

## 它能做什么

MCP（Model Context Protocol）是 AI 助手调用外部工具的通用方式。接上 FetchPan 后，你可以直接对 AI 说：“帮我下载这个百度网盘链接”。

AI 会先检查这个网站我们支不支持，分享里有文件夹时列出文件让你挑，然后在我们的服务器上把文件准备好，给你一个下载直链。

不用令牌就能用：同一网络的前几个文件免费。登录后创建令牌，每天有更多免费文件，也能用流量高速下载。

## 接入方式

不用令牌就能试：只填服务器地址就行（Claude Code：claude mcp add --transport http fetchpan https://fetchpan.com/mcp）。想每天免费 3 个文件，就在第 1 步创建令牌，换掉 YOUR_TOKEN。每个教程大约两分钟。

### Codex（OpenAI Codex 命令行、IDE 插件和应用）

1. 在上面创建令牌并复制。
2. 把令牌写进你的终端配置文件（~/.zshrc 或 ~/.bashrc），变量名为 FETCHPAN_TOKEN，然后重启终端。
3. 打开 ~/.codex/config.toml（没有就新建），加入下面的 [mcp_servers.fetchpan] 配置。如果只想在某个项目里用，把它放进已信任项目里的 .codex/config.toml。
4. 启动 Codex，输入 /mcp，应该能看到 fetchpan。在普通终端里运行 codex mcp list 也能看到。
5. 对它说：“用 FetchPan 检查这个链接：……”。

添加到 `~/.codex/config.toml`

```toml
# 1) in ~/.zshrc or ~/.bashrc, then restart the terminal:
export FETCHPAN_TOKEN="YOUR_TOKEN"

# 2) in ~/.codex/config.toml:
[mcp_servers.fetchpan]
url = "https://fetchpan.com/mcp"
bearer_token_env_var = "FETCHPAN_TOKEN"
```

如果你是从应用图标而不是终端启动 Codex，它可能读不到终端里的环境变量。这时把 bearer_token_env_var 那一行换成：http_headers = { Authorization = "Bearer YOUR_TOKEN" }（令牌会明文保存在文件里，请保管好这个文件）。

### WorkBuddy

1. 在上面创建令牌并复制。
2. 在 WorkBuddy 里打开 Connectors（连接器），选 Custom connector（自定义连接器），点右上角的 Configure MCP（配置 MCP），会打开文件 ~/.workbuddy/mcp.json。不同版本的菜单名称可能略有不同。
3. 把下面的 fetchpan 配置加到 mcpServers 里，原来已有的条目保留不动，然后点保存。
4. 打开 My MCP（我的 MCP），把 fetchpan 开关打开。如果 WorkBuddy 问你是否信任这个服务，点确认。
5. 新建一个任务，说：“列出 FetchPan 的工具。”应该能看到 download、check_link、get_account。

添加到 `~/.workbuddy/mcp.json`

```json
{
  "mcpServers": {
    "fetchpan": {
      "type": "http",
      "url": "https://fetchpan.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}
```

### Claude Code

1. 在上面创建令牌并复制。
2. 在终端里运行下面的命令。
3. 运行 claude mcp list，或在 Claude Code 里输入 /mcp，fetchpan 应显示为已连接。
4. 对它说：“用 FetchPan 下载这个链接：……”。

```bash
claude mcp add --transport http fetchpan https://fetchpan.com/mcp \
  --header "Authorization: Bearer YOUR_TOKEN"
```

## 工具列表

共 10 个工具。通常智能体只需要用 download。连接、查看工具、下载前几个免费文件（同一网络每天 1 个，共 5 个）都不需要令牌；高速下载、查看账号和付款链接需要令牌。

| 工具 | 作用 | 消耗 | 令牌 |
| --- | --- | --- | --- |
| `download` | 给它一个链接，它会等文件准备好并返回下载地址。如果等待时间内没准备好，会返回任务 ID 让你继续查询。分享里有多个文件时，会先返回文件列表让你挑一个。 | 1 次免费，或流量（极速） | 前几个免费 |
| `check_link` | 这个网站是否支持、现在是否可用？ | 不消耗 | 不需要 |
| `list_supported_sites` | 全部支持的网站及实时状态。 | 不消耗 | 不需要 |
| `list_files` | 打开夸克或 PikPak 分享里的文件夹，找到要的文件（再用 download 带上 share_id 和 file_id 下载）。 | 不消耗 | 不需要 |
| `start_download` | 开始一个任务但不等待，返回任务 ID。 | 不消耗 | 前几个免费 |
| `get_job` | 任务状态，以及免费或极速下载分别要花多少。 | 不消耗 | 前几个免费 |
| `get_download_link` | 获取已完成任务的下载地址（免费或极速）。 | 1 次免费，或流量（极速） | 前几个免费 |
| `get_account` | 你的邮箱、流量余额、每天免费次数和最近的下载。 | 不消耗 | 需要 |
| `list_packages` | 可以购买的流量包。 | 不消耗 | 不需要 |
| `create_payment_link` | 生成流量包的付款页，交给你来付款。只有人可以付款。 | 不消耗 | 需要 |

## 在线调用测试

服务器是无状态的：不用先初始化，一个 POST 就是一次调用。下面两个调用不需要令牌，不会创建下载任务。

### 检查链接 check_link

```bash
curl -X POST https://fetchpan.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"check_link","arguments":{"url":"https://pan.baidu.com/s/1AbCdEfGh"}}}'
```

### 全部工具 tools/list

```bash
curl -X POST https://fetchpan.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
```

## 想要更多免费文件？创建令牌

登录后在开发者页创建 API 令牌，加到 MCP 配置里：每天有更多免费文件，也能用流量高速下载。 https://fetchpan.com/zh/developers