MCP server for Quark drive (夸克网盘) providing file management, download, upload, and sharing capabilities
Server has 17 tools with descriptions and basic input types, but critical gaps undermine quality. Input schemas are inferred from Go struct tags (jsonschema annotations) rather than explicitly registered with JSON Schema in the MCP tool definitions. The code shows mcp.AddTool() calls with only Name and Description, no InputSchema field visible. This means LLMs cannot see parameter constraints, types, or required fields at protocol level. Descriptions are present but generic (avg ~120 chars); many lack actionable guidance on when to use each tool or what happens on failure. No output schemas documented. No error handling guidance. No tool annotations (readOnlyHint, destructiveHint). Destructive tools like delete, move, and regex_rename lack confirmation patterns. Parameter descriptions exist in struct tags but are not surfaced to the MCP protocol layer.
取消正在运行的下载任务。需要提供任务ID。
复制文件或文件夹到目标目录。使用 '/' 表示根目录。例如:将 '/源/文件.txt' 复制到 '/目标目录/'
在指定路径创建新文件夹。例如:'/父文件夹/新文件夹' 或直接使用 '新文件夹' 在根目录创建。
删除指定路径的文件或文件夹。支持批量删除,传入路径数组即可。例如:['/文件夹/文件.txt', '/文件夹/子文件夹']
启动异步下载任务,将夸克网盘文件下载到本地。返回任务ID,可使用 get_download_status 查询进度。支持并发下载(3线程,10MB分片)。
根据任务ID查询下载任务的状态和进度。返回状态(pending/running/completed/failed/canceled)、进度百分比、已下载字节等信息。
Input schemas not registered with MCP protocol. Tools use mcp.AddTool() with only Name and Description; no InputSchema field visible. Parameter types and constraints defined in Go struct tags are not exposed to LLM clients. LLMs cannot see which parameters are required, their types, or valid value ranges.
No output schemas documented. Tools return results but LLMs have no formal specification of response structure, field types, or pagination. Forces LLMs to infer output shape from examples or trial-and-error.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 50 | 2026-07-28+ | v2 |
获取文件或文件夹的详细信息,包括名称、大小、类型、创建和更新时间。例如:'/文件夹/文件.txt'
获取分享链接中指定文件夹内的文件列表。使用 folder_id='0' 表示根目录,或传入文件夹的 fid 浏览子目录。例如:share_url='https://pan.quark.cn/s/abc123', folder_id='文件夹fid'
获取夸克分享链接根目录的文件列表。返回分享中所有文件和文件夹的信息。例如:share_url='https://pan.quark.cn/s/abc123' 或带密码 'https://pan.quark.cn/s/abc123?pwd=xyz'
列出所有下载任务及其状态信息。
列出指定目录下的所有文件和文件夹。使用 '/' 或空字符串表示根目录。
移动文件或文件夹到目标目录。使用 '/' 表示根目录。例如:将 '/源/文件.txt' 移动到 '/目标目录/'
使用正则表达式批量重命名文件夹内的文件。例如:path='/photos', pattern='IMG_(.*)', replacement='Photo_$1'
重命名文件或文件夹。需要提供原路径和新名称。例如:'/文件夹/旧名称' 重命名为 '新名称'
将分享链接中的文件保存到自己的夸克网盘。需要提供分享链接、目标保存路径。可通过 folder_id 指定文件所在的文件夹(默认为根目录),可选指定要保存的文件ID列表(留空则保存该文件夹下全部文件)。例如:保存根目录所有文件 share_url='https://pan.quark.cn/s/abc123', dest_path='/来自分享';保存子目录特定文件 share_url='https://pan.quark.cn/s/abc123', folder_id='文件夹fid', file_ids=['文件fid'], dest_path='/来自分享'
在指定目录下递归搜索文件或文件夹。根据关键词匹配文件名。例如:path='/文件夹', keyword='photo'
将本地文件上传到夸克网盘。需要指定目标文件夹路径(使用 '/' 表示根目录)和本地文件路径。
Destructive tools lack confirmation or dry-run patterns. delete, move, regex_rename, and save_from_share can cause data loss but have no confirmation step or preview capability. Agents cannot safely preview changes before committing.
No tool annotations. Tools lack readOnlyHint, destructiveHint, or idempotentHint metadata. LLMs cannot distinguish safe read operations from destructive writes without parsing descriptions.
No error handling guidance. Tool descriptions do not explain what errors can occur, how to recover, or what the LLM should do next. Agents will fail silently or retry blindly on errors.