论文解析工具

论文翻译器

使用GitHub Copilot Agent的MCP工具集来解读研究论文

功能概述

PaperInterpreter是一组工具，可自动解析研究论文PDF文件，生成Markdown报告和图像，并与代理/MCP工具协作。通过与github copilot agent协作使用，它能创建报告，以便让具备基础知识水平的人理解材料科学和AI相关的论文内容。主要功能如下。

• PDF转Markdown（提取正文文本和图像）

  • 实际处理 tools.PDFTools.pdf_to_markdown（实施： 工具/PDF工具.py）将进行。
  • 作为MCP工具 InterpreterMCP.pdf_to_markdown_tool（定义： InterpreterMCP.py 翻译为中文是：“MCP解释器.py”。不过，这里的“MCP”可能是一个特定上下文或项目中的缩写，具体含义需要根据上下文来确定。在没有具体上下文的情况下，我们只能将其直译为“MCP解释器”。）已公开。

• 网页辅助搜索

  • 作为根据需要收集相关信息的包装器 tools.GoogleSearch.getSearchResponse（实施： 工具/GoogleSearch.py）可以使用。

• 作为MCP服务器的公开

  • InterpreterMCP.py（InterpreterMCP.py 翻译为中文是：“MCP解释器.py” 或者根据上下文，也可以翻译为“用于MCP的解释器脚本.py”，但通常简称为“MCP解释器.py”即可。）使用FastMCP来构建工具集和提示（InterpreterMCP.MatSci_Interpreter_prompt）将公开。可通过devcontainer设置使其常驻并从代理中使用（设置： .devcontainer/（开发容器配置文件）devcontainer.json）。

• 输出格式和工作流程

  • 转换结果将保存至指定的Markdown文件和图片目录（默认： materials）中输出，转换函数作为返回值 {"md_text": md_text, "dest_dir": str(dest_dir)} 予以返还（参照： tools.PDFTools.pdf_to_markdown）。

• 开发/执行环境（devcontainer）

  • 通过 devcontainer 自动安装依赖项并引入 Playwright 浏览器（脚本： .devcontainer/setup.sh 翻译为中文是：“.devcontainer 设置脚本”设定： .devcontainer/目录下的devcontainer.json文件）。

系统概要图-Ver1.0

• 与GitHub Copilot Agent配合使用的系统如下所示。
• 目前网络搜索功能尚不完善。今后我们计划增加类似deepresearch的功能，以便进行更高级的分析。

使用方法（简易版）

1. 请确保已安装依赖项并已启动 devcontainer（devcontainer 的初始化 .devcontainer/setup.sh 翻译为中文是：“开发容器/设置脚本” （将进行）。
2. 本地一次性执行示例（直接从Python调用）：
   • 例： tools/PDFTools.pdf_to_markdown 直接使用
     • 在Python REPL或脚本中：
       • from tools.PDFTools import pdf_to_markdown
       • pdf_to_markdown("PhysRevB_68_245409/PhysRevB.68.245409.pdf", "report.md")
     • 实施参考： tools.PDFTools.pdf_to_markdown
3. 通过MCP使用时：
   • InterpreterMCP.py（InterpreterMCP.py 翻译为中文是：“MCP解释器.py” 或者更自然地表达为 “用于MCP的解释器脚本.py”。这里，“MCP”可能代表某个特定的系统、协议或模块的名称，具体含义需根据上下文确定。如果将其作为 devcontainer 的 MCP 服务器启动，从代理 InterpreterMCP.pdf_to_markdown_tool 和 InterpreterMCP.MatSci_Interpreter_prompt 可通过此进行处理。
4. 辅助使用Google搜索时：
   • tools.GoogleSearch.getSearchResponse 可参照该内容，获取搜索结果的URL并作为附加信息使用（实现： 工具/GoogleSearch.py）。
5. 注意输出位置和图像路径：
   • pdf_to_markdown 会将原PDF文件移动到以标题命名的安全目录下进行处理。输出的 report.md 请在引用图片时使用相对路径插入。
6. 理论表述（参考）
   • 公式可以以 KaTeX 格式包含在 README 等文件中。
   • 例：
     复制

     $ \gamma = \dfrac{G(T,p,\{n_x\}) - \sum_x n_x \mu_x(T,p_x)}{A} $
     

     ➡️

如需了解更多使用方法及事先准备的相关信息，请访问下一页进行确认。

• 事先准备：准备说明文件（或：准备指南）
• 使用方法详情：如何使用.md（文件名，表示一个Markdown格式的文件，内容关于使用方法）

参考

• 实施文件：
  • InterpreterMCP.py 翻译为中文是：“MCP解释器.py” 或者更具体地，可以理解为“用于MCP的解释器脚本.py”。这里，“Interpreter”指的是解释器，“MCP”可能代表某个特定的系统、协议或框架的缩写，而“.py”表示这是一个Python脚本文件。（MCP 工具定义·提示）
  • 工具/PDF工具.py（tools.PDFTools.pdf_to_markdown （实施）
  • 工具/GoogleSearch.py（tools.GoogleSearch.getSearchResponse （实施）
  • .devcontainer/目录下的devcontainer.json文件（开发容器设置）
  • .devcontainer/setup.sh 翻译为中文是：.devcontainer/设置脚本.sh（或简化为“.devcontainer/安装脚本.sh”，具体翻译可能根据上下文有所调整，但核心意思是这是一个位于.devcontainer目录下的用于设置或安装的脚本文件）（初始安装脚本）