Arxiv Search Mcp Server

arXiv 検索 MCP サーバー

公式 arXiv API を使用して、arXiv.org 論文の検索機能を提供する MCP（Model Context Protocol）サーバーです。

特長

• 語句で検索：タイトル、要旨、本文内のキーワードで論文を検索します
• 分野で絞り込み：arXiv の分野カテゴリ（物理学、cs、数学など）で結果を絞り込みます
• 日付範囲で絞り込み：投稿日の範囲で論文を絞り込みます
• 結果数を設定可能：返される結果の数を指定できます（最大 2000 件）
• PDF URL を含む：論文の PDF に直接アクセスできるリンクを含みます
• 包括的なメタデータ：著者名、要旨、カテゴリ、公開日などを含みます

インストール

PyPI から（推奨）

pip install arxiv-search-mcp-server

ソースから

1. リポジトリをクローンします：

git clone https://github.com/gavinHuang/arxiv-search-mcp.git
cd arxiv-search-mcp

2. パッケージをインストールします：

pip install -e .

使用方法

サーバーの実行

CLI コマンドとして（pip install 後）

arxiv-search-mcp

Python モジュールとして

python -m arxiv_search_mcp.server

ソースから

python src/arxiv_search_mcp/server.py

利用可能なツール

1. search_arxiv_papers

さまざまな絞り込みオプションを使って、arXiv の論文を検索します。

パラメーター：

• terms（必須）：論文のタイトル、要旨、本文内で検索する語句
• subject（任意）：絞り込みに使用する分野カテゴリ（利用可能なカテゴリは以下を参照）
• start_date（任意）：論文を絞り込む開始日（YYYY-MM-DD 形式）
• end_date（任意）：論文を絞り込む終了日（YYYY-MM-DD 形式）
• max_results（任意）：返す結果の最大数（デフォルト：10、最大：2000）

例：

search_arxiv_papers(
    terms="quantum computing",
    subject="quant-ph",
    start_date="2023-01-01",
    end_date="2023-12-31",
    max_results=20
)

2. get_subject_categories

絞り込みに使用できる分野カテゴリの一覧を取得します。

戻り値： カテゴリコードとその説明の辞書。

利用可能な分野カテゴリ

• physics - 物理学（一般）
• astro-ph - 天体物理学
• cond-mat - 物性物理学
• gr-qc - 一般相対性理論および量子宇宙論
• hep-ex - 高エネルギー物理学 - 実験
• hep-lat - 高エネルギー物理学 - 格子
• hep-ph - 高エネルギー物理学 - 現象論
• hep-th - 高エネルギー物理学 - 理論
• math-ph - 数理物理学
• nlin - 非線形科学
• nucl-ex - 原子核実験
• nucl-th - 原子核理論
• quant-ph - 量子物理学
• math - 数学
• cs - コンピューターサイエンス
• econ - 経済学
• eess - 電気工学およびシステム科学
• stat - 統計学
• q-bio - 定量生物学
• q-fin - 数理ファイナンス

レスポンス形式

検索結果には、各論文について以下の情報が含まれます。

{
  "arxiv_id": "2301.12345",
  "title": "Paper Title",
  "authors": ["Author 1", "Author 2"],
  "abstract": "Paper abstract...",
  "categories": ["cs.LG", "cs.AI"],
  "published_date": "2023-01-15",
  "pdf_url": "http://arxiv.org/pdf/2301.12345v1",
  "arxiv_url": "http://arxiv.org/abs/2301.12345",
  "comment": "Author comments",
  "journal_ref": "Journal reference if available",
  "doi": "DOI if available"
}

API の制限

• 1 回のリクエストにつき最大 2000 件（arXiv API の制限）
• レート制限：API の呼び出しは適切な間隔を空けてください（arXiv は、一括処理ではリクエスト間に 3 秒の遅延を設けることを推奨しています）
• デフォルトでは、関連度順に結果が返されます

エラー処理

サーバーはさまざまなエラー条件に対応します。

• 無効な検索パラメーター
• ネットワーク接続の問題
• arXiv API のエラー
• 不正な形式のレスポンス

エラーは、説明的なメッセージを含む構造化形式で返されます。

依存関係

• fastmcp - MCP サーバーフレームワーク
• requests - arXiv API 呼び出し用 HTTP クライアント
• feedparser - Atom/RSS フィードの解析
• urllib3 - URL 処理ユーティリティ

ライセンス

このプロジェクトは arXiv API 利用規約に従います。arXiv のリソースを尊重し、API を責任を持ってご利用ください。