jmiao24/Paper2Agent

Paper2Agent – 将研究论文转变为交互式 AI 代理

它是什么 – Paper2Agent 是一个基于 Python 的多代理系统，可自动将科学论文（及其附带的代码仓库，若有）转换为 Micro-Component-Program (MCP) 服务器。生成的服务器将论文的方法公开为可调用的工具，可从 Claude Code、OpenAI Codex 或 Gemini CLI 等 AI 编程助手访问。实际上，用户要求其编程代理“安装 Paper2Agent 技能”，然后“代理化”一篇论文；该技能会生成专业子代理来解析论文、建立隔离环境、封装原始代码、执行验证测试，最后将所有内容打包成一个可在本地运行或托管于 Hugging Face 的 ZIP 文件。

主要功能

• 一键转换 – 提供论文（以及选用的源码仓库）的 URL 或本地路径，该技能即可产生可立即运行的 MCP 服务器。
• 并行专业代理 – 协调器会针对文献解析、依赖性解析、代码测试和验证等任务启动独立代理，确保工作流程的可重现性。
• 经过验证、可重现的输出 – 生成的 ZIP 包含一个 USAGE.md，其中列出确切的解释器版本、依赖性列表和测试结果，确保服务器能开箱即用。
• 灵活部署 – MCP 可在本地运行或上传为 Hugging Face Space；README 列出了 AlphaGenome、Scanpy 和 TISSUE 的现成托管服务器。
• 安全的机密处理 – API 密钥从环境变量读取，绝不会写入生成的代码或笔记本中。

典型工作流程

1. 安装技能 – 将 skills/paper2agent 文件夹复制到编程助手的个人技能目录中（Claude Code 与 Codex 的路径不同）。
2. 调用技能 – 在代理的聊天窗口中，发出如下提示：

   /paper2agent Convert https://github.com/scverse/scanpy into tested MCP tools in Scanpy_Agent.
   Focus on the "Preprocessing and clustering" tutorial.
   

3. 代理协调 – 该技能会生成子代理来：
   • 下载论文和仓库，
   • 推断所需的运行环境（Python、R、GPU 等），
   • 将原始函数封装为 MCP 端点，
   • 运行论文本身的测试或提供的笔记本以验证正确性。
4. 接收 ZIP – 输出包含服务器代码、USAGE.md 和演示工具的 USAGE.ipynb。
5. 连接到您的编程助手 – 在本地解压缩并运行服务器，或使用 claude mcp add 指令将助手指向托管的 Hugging Face URL。

演示亮点

• AlphaGenome Agent – 接受基因变异查询并使用 AlphaGenome MCP 返回致病基因。
• TISSUE Agent – 提供具有置信区间的空间转录组学预测，并具备不确定性感知能力。
• Scanpy Agent – 对用户提供的 .h5ad 文件执行单细胞预处理和分群。

安装检查清单

• 主机上已安装 Python 3.x 和 Git。
• 支持“技能”和并行子代理生成的编程代理平台（Claude Code、Codex 或 Gemini CLI）。
• 选用：目标论文代码所需的 GPU 或其他原生依赖性。

引用 – 若您在研究中使用 Paper2Agent，请引用该 Nature 文章：

@article{miao2026paper2agent,
  title={Reimagining research papers as interactive and reliable AI agents},
  author={Miao, Jiacheng and Davis, Joe R. and Zhang, Yaohui and Pritchard, Jonathan K. and Zou, James},
  journal={Nature},
  year={2026},
  doi={10.1038/s41586-026-11044-y},
  url={https://www.nature.com/articles/s41586-026-11044-y}
}

总结 – Paper2Agent 让您能将科学出版物中描述的方法转变为即插即用的 AI 工具，大幅减少重现和重复使用尖端研究所需的手动工作。