SuperAPI AI 工具集

paperless-ngx

写作与研究

查看项目

更新于 10-15 23:46

技能介绍

用途:通过 MCP 工具编排 Paperless-ngx,管理文档及其元数据,共 42 个工具、9 个领域。

主要能力:文档(7 个工具)支持全文搜索、查看详情、单文档更新、删除备注、上传、下载和批量编辑;标签、往来方、文档类型、存储路径、自定义字段提供列表、创建、更新和批量删除/权限操作;任务工具查询上传任务状态,回收站工具列出、恢复与永久清空;邮件工具管理轮询账户、处理邮件并创建/更新/删除导入规则。

使用方式:先解析元数据 ID,如 list_tags、list_correspondents、list_document_types,再 post_document 上传,返回任务 UUID 而非文档 ID,需轮询 get_task(task_id) 直到 status="SUCCESS" 才得到文档 ID。搜索用 search_documents(query="..."),支持 tag:、type:、correspondent:、created:[2024 to 2025] 等语法;批量操作走 bulk_edit_documents 的 method,如 add_tag、set_document_type、merge、rotate、reprocess、delete。

限制:post_document 优先用 file_path,仅 stdio 传输支持,HTTP 传输拒绝;内联 base64 仅适合小文件。search_documents 会裁剪内容,需全文 OCR 用 get_document。matching_algorithm 为 0-6 整数。邮件规则只影响未来导入,账户凭据仅能在 Web UI 设置。文档删除为软删除,可恢复;标签、往来方、文档类型、存储路径、自定义字段的删除立即且永久。备注为追加式日志,无编辑操作;delete_tag 已弃用,改用 bulk_edit_tags。update_document 仅处理单文档,不支持批量改标题。custom field 需先用 list_custom_fields 取 ID。