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 工具，大幅減少重現和重複使用尖端研究所需的手動工作。