Skip to main content
Glama
Qihoo360

360 AI Cloud Drive MCP Server

by Qihoo360

360 AI 云盘 MCP Server & CLI

360 AI 云盘的 MCP Server + CLI 工具,为 AI Agent 和开发者提供云盘文件管理能力。基于 TypeScript / Node.js 构建,包含两个产物:

  • 360 AI 云盘 CLI — 面向终端用户和 AI Agent(通过 Shell)的命令行工具,命令名 360disk,结构化 JSON 输出。

  • 360 AI 云盘 MCP Server — 面向支持 Model Context Protocol (MCP) 的 AI Agent(如 Claude Desktop、Cursor)的服务端,支持 Stdio / Streamable HTTP / SSE 三种传输方式。

快速开始

npm install          # 安装依赖
npm run build        # 构建

Related MCP server: Storacha MCP Storage Server

MCP Server

在 MCP Client 配置文件中添加(适用于 Cursor、Claude Desktop 等):

{
  "mcpServers": {
    "360-ai-cloud-disk-mcp": {
      "command": "node",
      "args": ["build/index.js", "--stdio"],
      "env": {
        "API_KEY": "yunpan_xxxxxxxxxx"
      }
    }
  }
}

其他传输方式:

node build/index.js --stdio     # stdio 模式
node build/index.js --sse       # SSE 模式
node build/index.js --http      # Streamable HTTP 模式

MCP 工具

工具

说明

file-list

获取目录文件列表

file-search

搜索文件

file-save

保存文件到云盘(URL / 文本内容)

file-share

生成分享链接

file-move

移动文件或文件夹

file-rename

重命名文件或文件夹

make-dir

创建目录

get-download-url

获取下载链接

user-info

获取用户信息

file-upload-stdio

上传本地文件(仅 Stdio 模式)

file-download-stdio

下载云盘文件(仅 Stdio 模式)

CLI

node build/cli.js --help

# 登录
node build/cli.js auth login --api-key yunpan_xxxxxxxxxx

# 常用操作
node build/cli.js dir ls /                       # 列出目录
node build/cli.js file search "报告"             # 搜索文件
node build/cli.js file upload ./report.pdf --dest /文档/   # 上传文件
node build/cli.js file download <nid> --dir ./   # 下载文件
node build/cli.js file share /文档/报告.pdf       # 分享文件

CLI 命令

命令组

子命令

说明

auth

login / whoami / logout

鉴权管理

user

info

用户信息

dir

ls / mkdir

目录操作

file

mv / trans-copy / rename / rm / search / share / url / node-info / origin-size / clear-dir / config / save / append / exists / upload / download

文件操作

completion

install / uninstall / script

Shell 补全

CLI 特性

  • 结构化输出:默认 JSON,支持 --format text--quiet 模式

  • 统一错误码:语义化错误码,进程退出码对应

  • 管道集成:stdin 输入、批量操作,可与 jq 等工具组合

  • 超时/重试--timeout--retries 全局选项

  • Shell 补全:bash / zsh 自动补全

认证

使用前需要 360 AI 云盘 API 密钥(yunpan_ 开头)。

鉴权优先级:--api-key 参数 > API_KEY 环境变量 > ~/.360disk/config.json

环境变量

变量

说明

默认值

API_KEY

云盘 API 密钥

ECS_ENV

环境

prod

SUB_CHANNEL

子渠道

open

LOG_LEVEL

日志级别

info

许可证

Apache-2.0

Available Tools

11 tools
file-download-stdioB

获取云盘中指定文件的下载链接并支持直接下载文件。可以指定下载目录,默认下载到用户主目录的 .mcp-downloads 文件夹中。

ParametersJSON Schema
NameRequiredDescriptionDefault
nidYes文件的唯一标识ID,可通过文件列表或搜索获取
autoNo是否直接下载文件,默认为 true
downloadDirNo指定下载目录,必须有读写权限,默认为用户主目录下的 .mcp-downloads 文件夹

TDQS

B3.1/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure. It describes the core functionality (getting download links and supporting direct downloads) and some behavioral aspects (default directory, permission requirements). However, it lacks important behavioral details such as: whether this is a read-only or write operation, what happens when 'auto' is false versus true, error conditions, rate limits, authentication requirements, or what the output looks like (especially critical since there's no output schema).

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is appropriately concise with two sentences that efficiently convey the core functionality and key behavioral aspects. It's front-loaded with the primary purpose, followed by configuration details. There's minimal redundancy, though some information overlaps with the schema descriptions.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the complexity of a file download operation with 3 parameters, no annotations, and no output schema, the description is insufficiently complete. It doesn't explain what the tool returns (critical without output schema), doesn't describe error conditions, doesn't clarify the relationship between getting download links versus direct downloading, and provides minimal behavioral context for a tool that presumably performs file system operations.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already fully documents all three parameters. The description adds minimal value beyond the schema: it mentions the default download directory (.mcp-downloads) which is already in the schema's 'downloadDir' description, and reinforces that 'auto' controls direct downloading. No additional parameter semantics, constraints, or usage examples are provided beyond what's in the structured schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose: '获取云盘中指定文件的下载链接并支持直接下载文件' (get download links for specified files in cloud storage and support direct file downloads). It specifies the verb ('获取' - get/obtain) and resource ('云盘中指定文件' - specified files in cloud storage), but doesn't explicitly distinguish it from sibling tools like 'get-download-url' which might have overlapping functionality.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides implied usage context by mentioning default behavior (default download to .mcp-downloads folder) and prerequisites (download directory must have read/write permissions). However, it doesn't explicitly state when to use this tool versus alternatives like 'get-download-url' or 'file-save', nor does it provide exclusion criteria or comparative guidance with sibling tools.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

file-listA

获取云盘指定路径下的文件和文件夹列表,支持分页查询。返回文件名、大小、创建时间、修改时间等详细信息。

ParametersJSON Schema
NameRequiredDescriptionDefault
pageNo页码,默认从0开始。
page_sizeNo每页显示的条目数,默认50条。
pathNo要查询的云盘路径,默认为根目录'/'/

TDQS

A3.5/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden. It discloses key behavioral traits: it's a read operation (获取列表), supports pagination (分页查询), and returns detailed metadata (文件名、大小、创建时间、修改时间等). However, it doesn't mention potential limitations like rate limits, authentication requirements, or error conditions. The description adds value but lacks comprehensive behavioral context for a tool with no annotations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, efficient sentence that front-loads the core purpose and key features (pagination, return details). Every part earns its place: the first clause states the action, the second adds pagination support, and the third specifies return values. There is no wasted text or redundancy.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given no annotations and no output schema, the description provides basic completeness for a read-only list tool. It covers the purpose, pagination behavior, and return details, but lacks information on error handling, authentication, or output structure. For a tool with 3 parameters and no structured output definition, this is adequate but leaves gaps in contextual understanding.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, with all three parameters (page, page_size, path) well-documented in the schema. The description adds minimal semantic context by mentioning '指定路径' (specified path) and '分页查询' (pagination query), which aligns with the parameters but doesn't provide additional meaning beyond what the schema already covers. This meets the baseline for high schema coverage.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose: '获取云盘指定路径下的文件和文件夹列表' (get file and folder list from cloud drive at specified path). It specifies the verb (获取/获取列表) and resource (云盘指定路径下的文件和文件夹), making the function unambiguous. However, it doesn't explicitly differentiate from sibling tools like file-search, which might have overlapping functionality.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage context through '指定路径' (specified path) and '分页查询' (pagination query), suggesting this is for browsing directory contents rather than searching. However, it doesn't explicitly state when to use this versus alternatives like file-search (which might search across directories) or provide any exclusion criteria. The guidance is implied but not explicit.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

file-moveB

移动云盘中的文件或文件夹到指定位置。支持批量移动多个文件。

ParametersJSON Schema
NameRequiredDescriptionDefault
src_nameYes源文件或文件夹路径,多个文件用竖线(|)分隔,例如:/文件1.txt|/文件2.txt
new_nameYes目标文件夹路径,例如:/目标文件夹/

TDQS

B3.4/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries full burden. It mentions batch support but lacks critical behavioral details: whether it overwrites existing files, requires specific permissions, handles errors, or provides confirmation. For a mutation tool, this is a significant gap in safety and operational context.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences, front-loaded with core purpose and batch support. Zero wasted words, efficiently conveying essential information without redundancy.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a mutation tool with no annotations and no output schema, the description is incomplete. It lacks details on behavioral traits (e.g., overwrite behavior, error handling), return values, or integration with sibling tools. The high schema coverage doesn't compensate for missing operational context.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already documents both parameters thoroughly (src_name with format example, new_name with target folder). The description adds no additional parameter semantics beyond what the schema provides, meeting the baseline for high coverage.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the verb ('移动' meaning 'move') and resource ('云盘中的文件或文件夹' meaning 'files or folders in cloud storage'), specifying it supports batch operations ('批量移动多个文件'). It distinguishes from siblings like file-rename (renaming within same location) and file-save (saving new content).

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage for moving files/folders within cloud storage, but does not explicitly state when to use this vs. alternatives like file-rename (for renaming) or file-save (for creating/saving). No exclusions or prerequisites are mentioned.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

file-renameC

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

ParametersJSON Schema
NameRequiredDescriptionDefault
src_nameYes原文件或文件夹的完整路径,例如:/我的知识库/111.doc 或 /我的知识库/
new_nameYes新的名称(仅文件名或文件夹名,不含父路径)。文件夹名需以/结尾,例如:222.doc 或 我的知识库/

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden. It states the action ('rename') but doesn't disclose behavioral traits like whether it requires specific permissions, if it overwrites existing items with the new name, what happens on failure (e.g., if src_name doesn't exist), or if it's idempotent. This is a significant gap for a mutation tool with zero annotation coverage.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, efficient sentence in Chinese that directly states the tool's purpose without any fluff. It's front-loaded and appropriately sized for a simple rename operation, with every word contributing to clarity.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's complexity (a mutation operation with no annotations and no output schema), the description is incomplete. It lacks information on behavioral aspects (e.g., error handling, permissions), output format (what is returned on success/failure), and usage context compared to siblings. This is inadequate for a tool that modifies data.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, with clear descriptions for both parameters (src_name as original path, new_name as new name without parent path). The description adds no additional meaning beyond the schema, such as explaining path conventions or constraints (e.g., special characters allowed). Baseline 3 is appropriate since the schema does the heavy lifting.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('重命名' meaning 'rename') and the resource ('云盘中的文件或文件夹' meaning 'files or folders in cloud storage'). It distinguishes from siblings like file-move (which likely moves files) and file-save (which likely saves content), but doesn't explicitly differentiate from tools like make-dir (which creates directories) in terms of when to use rename vs create new.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. For example, it doesn't mention when to use file-rename versus file-move (which might handle path changes) or make-dir (for creating new folders with different names). There's no context about prerequisites, such as needing existing files/folders to rename.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

file-saveC

通过URL或文本内容保存文件到云盘

ParametersJSON Schema
NameRequiredDescriptionDefault
urlNo文件下载地址,url或content必传1个
contentNo文件内容(md格式),url或content必传1个,需要传用户指定的完整内容,不能省略任何部分
upload_pathNo云盘存储路径,必须以/开头和结尾。如不指定,默认为带有当前日期的'/AI为我下载/YYYYMMDD/'/AI为我下载/20260103/

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries full burden but offers minimal behavioral insight. It mentions the action ('保存' - save) implying creation/write, but doesn't disclose permissions needed, rate limits, file size constraints, overwrite behavior, or response format. For a write operation with zero annotation coverage, this leaves significant gaps in understanding how the tool behaves.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is extremely concise - a single sentence that efficiently communicates the core functionality. Every word earns its place: it specifies the action, two input methods, and destination. No wasted words or unnecessary elaboration.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a write operation with 3 parameters and no annotations or output schema, the description is insufficient. It doesn't explain what happens on success/failure, file naming conventions, format restrictions beyond 'md格式', or how conflicts are resolved. The agent lacks crucial information to use this tool effectively in production scenarios.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, providing good parameter documentation. The description adds marginal value by mentioning the two input methods (URL or text content) and that content should be in markdown format, but doesn't elaborate beyond what's in the schema descriptions. With high schema coverage, the baseline 3 is appropriate as the description doesn't significantly enhance parameter understanding.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('保存文件' - save file) and target resource ('到云盘' - to cloud drive), specifying two input methods (URL or text content). It distinguishes from siblings like file-download-stdio (download) and file-upload-stdio (upload via stdio), though not explicitly. However, it doesn't fully differentiate from all siblings like file-move or file-rename, keeping it at 4 rather than 5.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. It doesn't mention when to choose URL vs content input, or how this differs from sibling tools like file-upload-stdio or file-download-stdio. There are no prerequisites, exclusions, or context for selection among the many file-related tools.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

file-shareC

生成云盘文件的分享链接。支持批量生成多个文件的分享链接。

ParametersJSON Schema
NameRequiredDescriptionDefault
pathsYes要分享的文件全路径,多个文件用竖线(|)隔开,例如:/文件1.txt|/文件夹2/文件2.txt

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure. While it states the tool generates sharing links and supports batch processing, it doesn't describe important behavioral aspects: what permissions are required, whether links are public or private, expiration settings, rate limits, or what the output looks like. For a tool that creates shareable links (potentially sensitive operation), this is a significant gap.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is perfectly concise - two sentences that directly state the tool's function and its batch capability. Every word earns its place with zero redundancy. The structure is front-loaded with the primary purpose followed by an important capability.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given this is a file-sharing tool with no annotations and no output schema, the description is incomplete. It doesn't explain what the sharing links look like, their properties (expiration, permissions), error conditions, or how results are returned for batch operations. For a tool that creates potentially sensitive sharing links, more context about the operation's behavior and output is needed.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema description coverage is 100%, with the single parameter 'paths' fully documented in the schema. The description adds minimal value beyond the schema - it mentions batch processing ('支持批量生成多个文件的分享链接') which aligns with the schema's pipe-separated format, but doesn't provide additional semantic context about path formats, validation rules, or edge cases. Baseline 3 is appropriate when schema does the heavy lifting.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose: '生成云盘文件的分享链接' (generate sharing links for cloud drive files). It specifies the verb (generate) and resource (cloud drive file sharing links), making the function unambiguous. However, it doesn't explicitly differentiate from sibling tools like 'get-download-url' which might have overlapping functionality.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. It mentions batch processing capability ('支持批量生成多个文件的分享链接'), but doesn't clarify when to use this versus single-file sharing methods or how it differs from 'get-download-url'. No exclusions, prerequisites, or context for tool selection are provided.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

file-upload-stdioA

将本地文件上传到云盘指定路径。支持批量上传多个文件。

ParametersJSON Schema
NameRequiredDescriptionDefault
filePathsYes本地文件路径数组,例如:['/本地/文件1.txt', '/本地/文件2.jpg']
uploadPathNo云盘上传目标路径,默认为根目录'/'/

TDQS

A3.6/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries full burden. It mentions support for batch uploads, which is useful, but lacks critical behavioral details such as authentication requirements, file size limits, overwrite behavior, error handling, or rate limits. For a mutation tool with no annotations, this is a significant gap in transparency.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is two concise sentences with zero waste: the first states the core functionality, and the second adds the batch capability. It is front-loaded and appropriately sized for the tool's complexity, making it easy to grasp quickly.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool has no annotations, no output schema, and involves mutation (uploading files), the description is incomplete. It lacks details on return values, error conditions, side effects, or security considerations. For a file upload tool with such complexity, the description should provide more context to guide safe and effective use.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already documents both parameters thoroughly. The description adds minimal value by confirming the upload path is for the cloud drive, but does not provide additional semantics beyond what the schema states. With high schema coverage, the baseline is 3, but the description slightly enhances understanding, warranting a 4.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('upload'), the resource ('local files'), and the destination ('to cloud drive specified path'). It distinguishes from siblings like file-download-stdio (download) and file-move (move within cloud), making the purpose specific and well-differentiated.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage for uploading local files to cloud storage, but does not explicitly state when to use this tool versus alternatives like file-save (which might save content directly) or file-share (which shares existing cloud files). No exclusions or prerequisites are mentioned, leaving some ambiguity about appropriate contexts.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get-download-urlC

获取云盘中文件的下载链接。可以通过文件NID或路径获取。

ParametersJSON Schema
NameRequiredDescriptionDefault
nidNo文件nid,与fpath二选一必填
fpathNo文件路径,与nid二选一必填

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries full burden for behavioral disclosure. It states what the tool does (gets download links) but doesn't describe important behaviors: whether links are temporary or permanent, authentication requirements, rate limits, error responses, or what format the links are in. This leaves significant gaps for an agent to understand how to use the tool effectively.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is appropriately concise with two sentences that directly address the tool's purpose and parameter options. No wasted words or unnecessary information. However, it could be slightly more front-loaded by mentioning the parameter options in the first sentence.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a tool that retrieves download links with no annotations and no output schema, the description is incomplete. It doesn't explain what the output looks like (URL format, expiration, etc.), error conditions, or how this differs from similar sibling tools. The agent would need to guess about important behavioral aspects of this operation.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already documents both parameters completely. The description adds minimal value beyond the schema by mentioning the two parameter options exist ('可以通过文件NID或路径获取'), but doesn't provide additional context about when to choose one over the other or any parameter constraints not in the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose: '获取云盘中文件的下载链接' (get download links for files in cloud storage). It specifies the verb (获取/get) and resource (下载链接/download links for files), but doesn't explicitly differentiate from sibling tools like 'file-download-stdio' which might have overlapping functionality.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides minimal usage guidance: it mentions two alternative parameters (nid or fpath) but doesn't explain when to use this tool versus alternatives like 'file-download-stdio' or 'file-share'. No context about prerequisites, error conditions, or when-not-to-use scenarios is provided.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

make-dirC

在云盘中创建新文件夹,支持指定路径。

ParametersJSON Schema
NameRequiredDescriptionDefault
fnameYes要创建的文件夹完整路径,例如:/新文件夹/ 或 /文档/子文件夹/

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries full burden for behavioral disclosure. While '创建新文件夹' implies a write operation, it doesn't address permissions needed, whether it overwrites existing folders, error conditions, or what happens on success/failure. The description adds minimal behavioral context beyond the basic action.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, efficient sentence that states the core function and key capability. It's appropriately brief and front-loaded with the main action. No wasted words, though it could be slightly more informative about behavioral aspects.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a write operation tool with no annotations and no output schema, the description is insufficient. It doesn't explain what the tool returns, error conditions, permissions required, or how it interacts with existing files/folders. Given the complexity of a folder creation operation, more context is needed.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already documents the single parameter 'fname' with its type, description, and example. The description adds no additional parameter information beyond what's in the schema, meeting the baseline for high schema coverage.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('创建新文件夹' - create new folder) and resource ('在云盘中' - in cloud storage), making the purpose immediately understandable. It doesn't specifically distinguish from siblings like 'file-move' or 'file-rename', but the core function is unambiguous.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. There's no mention of prerequisites, when not to use it, or how it differs from other file operations like 'file-save' or 'file-upload-stdio' in the sibling list.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

user-infoB

获取360AI云盘用户详细信息。

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

B3.1/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden of behavioral disclosure. It states it retrieves user details but doesn't specify what details are included, whether it requires authentication, rate limits, or error conditions. This is a significant gap for a tool with zero annotation coverage.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, efficient sentence in Chinese that directly states the tool's purpose without any wasted words. It is appropriately sized and front-loaded, making it easy to parse.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the lack of annotations and no output schema, the description is incomplete. It doesn't explain what user details are returned, the format of the response, or any behavioral aspects like authentication needs. For a tool that likely involves sensitive user data, this is inadequate.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The tool has 0 parameters with 100% schema description coverage (since there are no parameters). The description doesn't need to add parameter details, so it meets the baseline of 4 for tools with no parameters, as it doesn't have to compensate for any gaps.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the verb ('获取' meaning 'get' or 'retrieve') and resource ('360AI云盘用户详细信息' meaning '360AI cloud disk user detailed information'), providing a specific purpose. However, it doesn't differentiate from sibling tools like 'file-list' or 'file-search' which might also involve user information indirectly, so it doesn't reach the highest score.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool versus alternatives. The description doesn't mention prerequisites, context, or exclusions, leaving the agent to infer usage based on the tool name alone.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

TDQS

B3.4/5.0
Disambiguation4/5

Most tools have distinct purposes focused on specific file operations (e.g., list, move, rename, search, share, upload, download, create folder), with clear boundaries. However, there is some overlap between 'file-download-stdio' and 'get-download-url', as both handle download links, which could cause minor confusion in selection.

Naming Consistency4/5

The naming follows a consistent pattern of verb-noun with hyphens (e.g., file-list, file-move, file-rename), which is predictable and readable. The only deviation is 'user-info', which uses a noun-verb structure instead, but this is a minor inconsistency that doesn't significantly impact usability.

Tool Count5/5

With 11 tools, the count is well-scoped for a cloud drive server, covering essential file management operations (CRUD, search, share, user info). Each tool serves a clear purpose, and there are no redundant or missing tools that would make the set feel too thin or bloated.

Completeness5/5

The tool set provides comprehensive coverage for cloud drive operations, including full CRUD (create via upload/save, read via list/search, update via move/rename, delete implied by move/overwrite), file sharing, downloading, and user management. There are no obvious gaps that would hinder an agent from performing typical file management tasks.

Maintenance

ActivityMaintained
ResponsivenessSyncing

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Qihoo360/ecs_mcp_server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server