NOISE盘搜 MCP
给 AI 客户端提供网盘搜索工具（支持 MCP / HTTP 两种接入）

概述

NOISE 盘搜内置 MCP 服务，向 AI 客户端暴露可调用工具，用于实时检索网盘资源，并支持把 AI 生成/上传的文件一键保存到站内网盘。

为了兼容更多客户端，提供两种接入方式：

  • MCP（SSE 传输）：支持 MCP 的客户端可直接连接
  • HTTP（/api/mcp/search）：任何支持 HTTP 工具/函数调用的客户端都可接入

启用与鉴权

启用“内置 MCP（搜索）”后即可使用；访问令牌为可选项。

读取中MCP 服务
读取中Token 鉴权

未设置令牌：公开服务，无需鉴权。

方式 A：MCP（SSE）

GET/api/mcp/sse
POST/api/mcp/message?sessionId=...

工具列表包含：

  • pansou_search：网盘搜索（支持自然语言描述）
  • pansou_netdisk_upload：站内网盘上传（支持自然语言，成功后返回可访问链接）
🔍 搜索工具自然语言示例

可以直接用自然语言描述你的需求：

帮我找最近一个月的夸克网盘资源
只搜TG频道的电视剧黑镜，要第2页
找站内资源里的编程课程，返回20条
📤 网盘上传工具自然语言示例

支持自然语言描述，工具会自动解析文件名：

把这张图片上传到网盘，保存为 image.png
将这个文档保存到云盘
把生成的文件上传到云端并给我链接
保存该文件到网盘
📤 网盘上传参数说明

上传支持 text / base64 / url 三种方式；也可以通过 q 参数用自然语言描述。 若后台设置了 Token，则上传需要携带 Token；未设置 Token 时可公开使用（但仍受“站内网盘”的公共上传开关与大小限制约束）。 

示例 1：文本内容 + 自然语言指令
q: "把这段文字保存为 note.md"
text: "# Hello\n\n这是一段文本内容"

示例 2：Base64 图片（可带 data: 前缀）
fileName: "photo.jpg"
base64: "data:image/jpeg;base64,/9j/4AAQSkZJRg..."

示例 3：从 URL 拉取文件上传
fileName: "report.pdf"
url: "https://example.com/report.pdf"

示例 4：仅使用自然语言（配合 AI 生成的内容）
q: "将生成的图片保存到网盘，名为 artwork.png"
base64: "data:image/png;base64,..."
通用配置示例（仅 url 字段的客户端）
{
  "mcpServers": {
    "pansou": {
      "url": "https://<你的域名>/api/mcp/sse"
    }
  }
}
Cherry Studio 配置示例（需要显式 type=sse）
{
  "mcpServers": {
    "pansou": {
      "type": "sse",
      "url": "https://<你的域名>/api/mcp/sse"
    }
  }
}

方式 B：HTTP（兼容模式）

POST/api/mcp/search
POST/api/mcp/netdisk/upload

请求体：

请求体
{
  "q": "关键词或自然语言描述",
  "page": 1,
  "pageSize": 10,
  "format": "md"
}
curl 示例
curl -X POST "https://<你的域名>/api/mcp/search" \
  -H "content-type: application/json" \
  -d '{"q":"最近一周 夸克 黑镜 返回10条","page":1,"pageSize":10,"format":"md"}'
站内网盘上传 curl 示例（multipart）
curl -X POST "https://<你的域名>/api/mcp/netdisk/upload" \
  -F "file=@./example.bin" \
  -F "fileName=example.bin" \
  -F "caption=from mcp"