Skip to main content
Glama

paper-search MCP

日本語・英語の学術論文を検索し、本文の取得可能性を判定し、公開 PDF をローカル収集する MCP サーバー。Claude Code などの LLM エージェントから利用することを想定しています。

  • 英語論文: arXiv(API キー不要)

  • 日本語論文: CiNii Research(API キー不要。appid は任意)

  • 本文解決: arXiv PDF / J-STAGE 公開論文 / 検索結果に含まれる既知 URL(機関リポジトリ等)

データソースごとの API 差異はサーバー内部で吸収し、LLM には統一された 4 つの Tool だけを公開します。

提供 Tool

Tool

役割

search_papers

日英複数ソースの並列検索。正規化・重複除去・ランキング済みの候補を返す

inspect_papers

複数論文の詳細と本文取得可能性(available / restricted 等)を一括調査

collect_papers

公開 PDF を一括ダウンロードしローカル保存(SHA-256 記録、重複防止)

get_collected_papers

収集済みファイルのローカルパス等を返す

すべてバッチ入力(paper_ids[])で、一部の失敗があっても成功分は返します(部分成功)。

Related MCP server: paper-mcp

セットアップ

要件: uv(Python 3.12+ は uv が自動管理)

git clone <this-repo>
cd mcp-paper-search
uv sync

Claude Code への登録

プロジェクトルート(または利用したいワークスペース)の .mcp.json に追加:

{
  "mcpServers": {
    "paper-search": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/mcp-paper-search", "paper-search-mcp"],
      "env": {
        "PAPER_SEARCH_DATA_DIR": "/path/to/mcp-paper-search/data"
      }
    }
  }
}

環境変数

変数

必須

説明

PAPER_SEARCH_DATA_DIR

任意

PDF・収集記録の保存先(デフォルト ./data)

CINII_APP_ID

任意

CiNii Research の appid。なしでも動作するが、継続利用には NII へのアプリケーション登録を推奨

使い方の例

Claude Code に次のように依頼すると、search → inspect → collect のワークフローが実行されます。

組込みソフトウェア開発における AI エージェント活用について、
日本語と英語の論文を探して、関連度の高いものを PDF で収集して。

収集した PDF は data/papers/{年}/{paper-id}.pdf に保存されます。

開発

uv run pytest                  # offline テスト(実 API は叩かない)
uv run pytest -m live          # 実 API との整合検証(arXiv / CiNii)
uv run ruff check src tests   # lint
uv run mypy                    # 型チェック(strict)

設計ドキュメントは docs/plan.md、開発時の規約は CLAUDE.md を参照してください。

実装状況

  • ✅ Phase 1–7: ドメインモデル / arXiv・CiNii 検索 / 検索統合(重複除去・ランキング)/ arXiv・J-STAGE 本文解決 / PDF 収集 / MCP サーバー

  • ⬜ Phase 8: 機関リポジトリ・DOI Resolver

  • ⬜ Phase 9: SQLite 永続化(現状は検索結果がプロセス内メモリのため、サーバー再起動後は再検索が必要)

  • ⬜ Skills(paper-discovery / literature-survey / paper-collection)

制約・ポリシー

  • 公開・合法的に取得可能な本文のみ収集します(認証突破・Shadow Library 非対応)

  • 各 API にはホスト単位の rate limit(arXiv 3 秒 / CiNii 1 秒 / J-STAGE 2 秒)を設けています

  • ダウンロード対象 URL はサーバーが解決した候補のみに限定し、SSRF 検証を行います

Available Tools

4 tools
collect_papersA

複数論文の本文 PDF を一括取得しローカル保存する。

公開・合法的に取得可能な本文のみ収集する。部分成功を許容し、 per-item の status(collected / already_collected / unavailable / restricted / failed)と理由を返す。

Inputs: paper_ids (required). Returns: object

get_collected_papersA

収集済み論文のローカル情報(パス・SHA-256)を返す。

paper_ids を省略すると収集済み論文の一覧を返す。

Inputs: paper_ids. Returns: object

inspect_papersA

複数論文の詳細メタデータと本文取得可能性を一括調査する。

search_papers が返した paper_id を渡す。ファイル保存は行わない。 fulltext.status: available / metadata_only / restricted / not_found / unknown。

Inputs: paper_ids (required). Returns: object

search_papersA

日英の学術論文を検索する。

languages(ja / en)に応じて arXiv・CiNii Research を検索し、 重複除去・ランキング済みの論文候補を返す。本文取得は行わない。 categories は分野フィルタ(例: cs.SE、cs.AI。arXiv のみ有効)。 1 データソースの障害は warnings として返し、検索全体は失敗しない。

Inputs: query (required), limit, offset, sources, +4 more. Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool has a clearly distinct role: searching, inspecting metadata, collecting full-text, and listing collected papers. There is no overlap or ambiguity.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern: search_papers, inspect_papers, collect_papers, get_collected_papers. Naming is uniform and predictable.

    Tool Count5/5

    With 4 tools, the set is well-scoped for the paper search and management workflow. Each tool serves a necessary step and none is redundant.

    Completeness4/5

    The workflow covers search, inspection, collection, and listing. A minor gap is the lack of a delete/remove operation for collected papers, but the core lifecycle is well covered.

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      A
      quality
      D
      maintenance
      Enables searching, downloading, and reading academic papers from multiple platforms including arXiv, Semantic Scholar, PubMed, bioRxiv, medRxiv, IACR, Google Scholar, RePEc/IDEAS, and Sci-Hub with PDF to Markdown conversion.
      29
      7
      -
    • A
      license
      A
      quality
      D
      maintenance
      Enables retrieval of academic paper metadata, PDFs, full text, citations, and references by title via Semantic Scholar, arXiv, and other sources.
      6
      40 PyPI
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables searching, downloading, and exporting academic papers from 20+ scholarly sources including arXiv, PubMed, and Semantic Scholar. Supports multi-source concurrent search, citation network tracing, and export to CSV, RIS, and BibTeX.
      1
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Aggregates academic paper search from multiple databases (OpenAlex, Semantic Scholar, etc.) with PDF storage and full-text search capabilities.
      1
      -