用途:获取飞书云文档的 Markdown 内容(Lark-flavored 格式),并处理文档中的图片、文件与画板。
主要能力:调用 feishu_mcp_fetch_doc 返回文档 Markdown;媒体以 HTML 标签形式出现,图片为 <image token=.../>,文件为 <view type="1"><file token=... name=.../></view>,画板为 <whiteboard token=.../>。这些媒体需通过 feishu_doc_media(action: download)单独获取。
使用方式:doc_id 为必填,可直接传文档 URL(如 https://xxx.feishu.cn/docx/Z1FjxxxxxxxxxxxxxxxxxxxtnAc,系统自动提取 token)或直接传 token。知识库 URL/token 也支持。下载媒体时从 HTML 标签提取 token,调用 feishu_doc_media,参数为 action: download、resource_token、resource_type: media、output_path。
Wiki 链接处理:/wiki/TOKEN 背后可能是云文档、电子表格或多维表格,不能直接假设为云文档。先调用 feishu_wiki_space_node(action: get, token: wiki_token)解析,从返回 node 获取 obj_type 与 obj_token,再按类型调用对应工具:docx 用 feishu_mcp_fetch_doc(doc_id=obj_token);sheet 用 feishu_sheet(spreadsheet_token=obj_token);bitable 用 feishu_bitable_* 系列(app_token=obj_token);其他类型告知用户暂不支持。
适用场景:读取飞书文档文本、下载文档内媒体、解析知识库链接类型、读写电子表格与操作多维表格。
限制:媒体不会随 Markdown 一并返回,必须另行下载;wiki 链接需先解析类型;其他文档类型暂不支持。