您可以将“附上显示问题的页面”转换为一个提示。GroupDocs.Viewer.Mcp 服务器从 PDF、Word、Excel 或 PowerPoint 文件中渲染您指定的页面，并将每个页面保存为具有可预测文件名的 PNG，保存在本地机器上，这样 Claude、Cursor 或 GitHub Copilot 就可以为错误报告、审阅备注或幻灯片生成图像：

渲染规范的第 1、4、9 页，并告诉我文件所在位置。

带有配置和故障排除的逐步版本请参阅文档：How to create page images of documents for reports and tickets.

为什么要自动化页面图像？

页面图像是最廉价的证据。支持工程师会附上显示错误总计的发票页面；审阅者会将每个更改页面的缩略图放入审阅备注中；演示者需要一张未重新格式化的图表。手动完成时，这些都意味着打开文件、找到页面、截屏并命名结果。每个文件的页数不同，工作难以批量处理。

如果渲染由真实引擎完成而不是由代理模拟，代理可以完成重复性工作。引擎会按照文档的分页方式进行分页，并每次生成相同类型的 PNG。

工作流程是什么？

  1. 将文件放在服务器可访问的位置。 挂载保存文档的文件夹，无论其中是 PDF 文件还是 Word 文件，这样渲染 DOCX 页面图像的方式相同。服务器从存储路径读取，并将图像写入输出路径，您可以使用 GROUPDOCS_MCP_OUTPUT_PATH 将其保持分离。
  2. 检查页数。 提示：“规范有多少页？” 代理调用 get_view_info 并读取 pageCount。这很重要，因为 render_page 不会拒绝超出文档末尾的页码。
  3. 命名页面。 提示：“渲染规范的第 1、4、9 页，并告诉我文件所在位置。” 代理会调用 render_page 三次，每页一次。
  4. 收集文件名。 文件为 specification_page1.png、specification_page4.png 和 specification_page9.png，位于输出文件夹中。代理报告这些路径。
  5. 附加它们。 如果您的客户端还连接了问题跟踪器或聊天 MCP 服务器，请让代理将文件附加到工单或消息中。此步骤使用其他服务器的工具，而不是本服务器。

如果您只想要文件，请说明，这样代理就不会描述每个图像：

只保存图像；您无需描述它们。

代理决定什么，引擎做什么？

决策或操作 代理 引擎
哪些页面是相关的 将“the pages with the pricing table”映射为页码，渲染或检查后 无
页面是否存在 调用 get_view_info 并进行比较 返回 pageCount 和页面尺寸
渲染 对每页调用一次 render_page 生成 PNG
文件命名 报告已保存的路径 保存为 <source-stem>_page<N>.png
附加到工单 使用其他服务器的工具 无

示例会话

基于文档中输出名称的示例说明，而非实际截图。

您：   渲染规范的第 1、4、9 页，并告诉我文件所在位置。只保存图像；无需描述它们。

代理： [calls render_page for page 1, page 4 and page 9]
       已保存：
         <output folder>/specification_page1.png
         <output folder>/specification_page4.png
         <output folder>/specification_page9.png

如何保持集合规模小？

渲染是每次调用一页，每个图像也会内联返回给代理。请求十页意味着十次调用和十张图像在对话中。只请求您需要的页面。一个明智的规则是先根据页数以及对于长文档的目录页挑选要渲染的页面。

常见用途

  • 错误报告。 手册或发票中显示问题的页面。
  • 文档审阅。 在审阅备注中，每个更改页面对应一张图像。
  • 幻灯片。 您想要的单个图表的图片，且无需重新格式化。

真实限制

  • 评估模式。 渲染的页面带有评估水印，服务器进程最多打开 15 个文档。如果图像离开您的团队，请先询问“Viewer 服务器是否已授权？”，这样代理会调用 get_license_status。
  • 每次调用一页。 没有多页工具。批处理是一系列调用。
  • 仅 PNG。 格式固定，分辨率不是可通过工具设置的参数。
  • 错误的页码仍会生成图像。 只有当文档有 12 页时，文件 _page12.png 才是第 12 页。请先检查页数。

常见问答

如何使用 AI 代理将 PDF 页面转换为图像？ 将 GroupDocs.Viewer.Mcp 服务器连接到您的客户端，并按页码请求页面。代理调用 render_page，PNG 会以 <name>_page<N>.png 的形式保存在输出文件夹中。

如何使用 AI 代理将文档预览附加到工单？ Viewer 服务器生成图像文件。要附加它，需要一个连接到同一客户端的问题跟踪器 MCP 服务器，它是一个拥有自己工具的独立服务器。

我可以在本地生成文档缩略图吗？ 可以。引擎在您机器上的服务器进程中运行，图像会写入您配置的输出文件夹。

深入了解