使用说明

MCP 工具（参数）

文稿智库 MCP 的工具与参数手册（权威）。如何挂到百炼 / 写 Node 示例，见 千问 MCP（对接）。

服务内两层路径：

  • / = 上传的原始文件
  • /wiki/ = 整理后的 Markdown（知识库称「知识页面」，任务文献库称「编译文稿」）
工具作用
guide说明 + 列出空间（slug、kind、文件数）；锁定连接时只显示当前空间
search浏览或关键词检索（可用 path / tags 缩小范围；list 默认不含 overview/log 等脚手架）
read读文件（路径 / 页码）
write创建或改整理页
delete删除（overview / log 受保护）

建议调用顺序：guide → search / read →（用户明确要求落稿时再）write。一般勿主动 delete。

入口

路径knowledge_base
/{slug}/mcp推荐。可省略；若传必须等于路径中的 slug
/mcp必传 slug（留空只列空间）；勿传 UUID

鉴权：Authorization: Bearer sv_…。挂载方式见 千问 MCP（对接）。

search：按科目用 tags（知识库推荐）

知识库中，为资料设置科目后会写入文档字段：

  • tags：[一级, 二级, 三级]，例如 ["生命医学", "医学", "临床医学"]
  • 目录路径：/一级/二级/三级/（随文档移动；无需依赖预建空文件夹）

按学科缩小检索范围时，工具参数请传 tags（AND：须同时包含所列标签），不要靠浏览空目录树，也不要把科目路径塞进 path。

推荐调用（模型侧 tool call）

# 某学科下的关键词检索
search(mode="search", query="免疫治疗", tags=["生命医学", "医学"])

# 精确到三级科目
search(mode="search", query="临床试验", tags=["生命医学", "医学", "临床医学"])

# 只列出某科目下的文件
search(mode="list", tags=["公共经管", "经济财政与金融"])

# 仅在整理结果里搜
search(mode="search", query="关键概念", path="/wiki/**")

# 全局 /mcp 时须带 slug
search(
  knowledge_base="your-space-slug",
  mode="search",
  query="临床试验",
  tags=["生命医学", "医学"]
)

业务代码如何通过 input 引导模型填 tags，见 千问 MCP · 按学科缩小范围。

参数说明

参数说明取值 / 示例
knowledge_base空间 slug/{slug}/mcp 可省略；全局 /mcp 必填
mode浏览或关键词检索list（默认，不含 overview/log/index.json/.keep）；search
query检索关键词search 时必填
path限定原始文件或整理结果；按学科用 tags见下表
tags文档须包含所列全部标签（AND）如 ["生命医学", "医学"]
limit返回条数上限默认 10

path 在 mode=search 时：

取值含义
*（默认）不限
以 /wiki 开头（如 /wiki/**）只搜整理结果
/ 或 /*只搜原始文件
其它无效（等同不限）

任务文献库通常不按科目目录组织；仍以 query + 可选 path 为主，tags 有则可用。

相关

千问 MCP（对接） · 概念说明 · 典型流程