Paperport

io.github.CloudCorpRecords由 GitHub 帳號 CloudCorpRecords 發布v0.1.0更新於 Nov 7, 2026

Search and read arXiv papers, with local paper storage.

已驗證STDIO僅桌面網頁搜尋與抓取檔案與儲存知識與記憶

概覽

AI 產生的概覽

搜尋 arXiv 公開 API、取得論文摘要，並把下載的論文保存在本機書架，供助理列出與再次閱讀。

可以做什麼
  • 依查詢詞搜尋 arXiv 論文，可限制結果數量、日期範圍與分類
  • 依論文 id 取得單篇論文的摘要、作者、日期與 PDF 連結
  • 下載論文的詮釋資料與摘要，存成本機 markdown 檔案
  • 列出本機書架中的論文，並讀取已存放論文的内容
適用情境
適合讓助理檢索 arXiv 文獻、取得摘要，並在本機保留少量論文以便日後離線查閱，不必再次連網查詢。
執行需求
以本機 stdio 程序執行，可透過 npx 使用 npm 套件，或使用 Docker 映像。需要連線至公開 arXiv API 的網路。無需驗證或 API 金鑰。儲存位置由環境變數 PAPERPORT_STORAGE_DIR 指定，否則使用工作目錄下的 papers 目錄。
安裝前請注意
下載的論文以 markdown 檔案保存，僅含詮釋資料與摘要，並非轉換後的 PDF 全文，因此 read_paper 回傳的是摘要檔案而非論文正文。下載會寫入本機儲存目錄。查詢詞與論文 id 會傳送到公開的 arXiv API。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Paperport，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

paperport

paperport is a small desk for arXiv work. It searches the public arXiv API, pulls back titles, authors, dates, categories and abstracts in a tidy shape, fetches the abstract for a single paper when you have its id, and keeps a local shelf of papers you have downloaded so you can list and re-read them later without going back to the network.

Install

bash
npx @reneturcios/paperport search "small language models"

Or run the container image:

bash
docker run -i ghcr.io/cloudcorprecords/paperport

The container defaults to the MCP server (see below). Pass CLI arguments to use it as a CLI instead.

CLI

Commands print JSON, except read, which prints the stored paper.

bash
# Search, with optional filterspaperport search "attention patterns" --max-results 5 \  --date-from 2024-01-01 --date-to 2024-12-31 --categories cs.CL,cs.LG
# One paper's abstractpaperport abstract 2401.12345
# Store a paper locally, then list and read the shelfpaperport download 2401.12345paperport listpaperport read 2401.12345
paperport --version

Downloaded papers are stored as <paper_id>.md files in the storage directory: the PAPERPORT_STORAGE_DIR environment variable when set, otherwise ./papers.

Exit codes: 0 on success, 1 when a paper cannot be found, fetched or read, 2 for usage errors.

MCP server

One bin serves both faces. The mcp subcommand starts a stdio MCP server:

bash
npx -y @reneturcios/paperport mcp

MCP client configuration:

json
{  "mcpServers": {    "paperport": {      "command": "npx",      "args": ["-y", "@reneturcios/paperport", "mcp"]    }  }}

Tools

ToolInputWhat it returns
search_papersquery (string, required), max_results (integer, optional), date_from / date_to (strings, optional, YYYY-MM-DD), categories (array of strings, optional)A list of papers: id, title, summary, authors, published, categories, and pdf_url.
get_abstractpaper_id (string, required)The paper's paper_id, title, abstract, authors, published, and pdf_url.
download_paperpaper_id (string, required)Stores the paper locally (see the gap note below) and returns its paper_id, title, storage path, and pdf_url.
list_papers(no input)The papers on the local shelf: each stored file's paper_id and path.
read_paperpaper_id (string, required)The stored paper's paper_id and full text content. Errors when the paper has not been downloaded.

Paper ids may be given bare (2401.12345), with a version suffix (2401.12345v2), or as a full arxiv.org/abs/... URL; they are normalised before use.

Known gap: downloaded papers are abstract files, not converted PDFs

The original tool this rebuilds converts each downloaded paper's PDF to markdown. paperport does not do that conversion: download_paper stores the paper's metadata and abstract — title, authors, categories, dates, and links to the abstract page and the PDF — as a markdown file, and read_paper returns that file. The full text of the paper is only available through the linked PDF. This is a deliberate, documented limitation of this version, not a silent one.

Development

bash
npm installnpm run build   # tsc -> dist/npm test        # node test runner over test/*.test.ts, no networknpm run dev     # run the CLI from source via tsx

License

MIT — see LICENSE.

來源：README.md，提交 461e5bc

工具

5

search_papers

Search arXiv papers by query.

輸入參數query必填date_todate_fromcategoriesmax_results

get_abstract

Get the abstract for an arXiv paper.

輸入參數paper_id必填

download_paper

Download an arXiv paper and store it locally.

輸入參數paper_id必填

list_papers

List papers stored locally.

無需輸入參數。

read_paper

Read a locally stored arXiv paper.

輸入參數paper_id必填

版本歷史

1
  1. v0.1.0最新Oct 31, 2026

評分

已滿足適用檢查項的 90%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分
  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分