ArXiv MCP Server

arxiv-mcp-server

エージェントによる文献調査向けのローカル MCP サーバーです。独自の特長は、原著論文の LaTeX をセクション単位で読み込めること、arXiv メタデータから BibTeX を取得できること、トピックを監視できることです。論文はディスク上に保存されます。基本的な作業の流れは、論文 ID → 概要 → 1 つのセクション → 引用です。検索は任意です。

インストール

標準のインストール方法は uvx arxiv-mcp-server です。コマンドベースの連携には、uvx を提供する uv が必要です。リポジトリのクローンや Python 環境のセットアップは不要です。

uvx arxiv-mcp-server

Claude Desktop や Kiro など、mcpServers JSON 形式に対応するクライアントには、この stdio 設定を追加してください。ほかのクライアントでは、トップレベルの servers オブジェクト、TOML、または独自の設定 UI を使用する場合があります。クライアントの MCP ドキュメントを参照してください。

{
  "mcpServers": {
    "arxiv": {
      "type": "stdio",
      "command": "uvx",
      "args": ["arxiv-mcp-server"]
    }
  }
}

標準の論文ディレクトリは ~/.arxiv-mcp-server/papers です。別のディレクトリを選択するには、"--storage-path", "/absolute/path/to/papers" を args に追加してください。

対応パッケージは PyPI で arxiv-mcp-server==0.8.2 として公開されています。同じ名前を使う無関係な npm パッケージがあるため、このサーバーを npm、pnpm、または npx arxiv-mcp-server でインストールしないでください。

公式 MCP レジストリに掲載されています。最新バージョンは 0.8.2 です。

検索ラッパーではない理由

検索、ソースの取得、引用グラフ、ダウンロードでは、それぞれ対応する外部サービスを呼び出します。ローカルに保たれるのは文献調査の流れです。著者が投稿した LaTeX を一度に 1 セクションずつ読み、信頼できる arXiv メタデータから BibTeX をエクスポートし、トピックの監視情報をディスクに保存します。サーバーは標準で stdio を介してローカルで実行されます。

claude mcp add --transport stdio --scope user arxiv -- uvx arxiv-mcp-server

claude plugin marketplace add blazickjp/arxiv-mcp-server
claude plugin install arxiv-mcp-server@arxiv-mcp

codex mcp add arxiv -- uvx arxiv-mcp-server

codex plugin marketplace add blazickjp/arxiv-mcp-server
codex plugin add arxiv-mcp-server@arxiv-mcp

hermes mcp add arxiv --command uvx --args arxiv-mcp-server
hermes mcp test arxiv

https://github.com/blazickjp/arxiv-mcp-server

デスクトップアプリケーションは、必ずしもターミナルと同じ PATH を引き継ぐとは限りません。ターミナルでは uvx arxiv-mcp-server が動作するのに、クライアントでサーバーへの接続に失敗したと表示される場合は、実行ファイルの絶対パスを確認してください。

# macOS and Linux
command -v uvx

# Windows PowerShell
(Get-Command uvx).Source

"command": "uvx" を取得した絶対パスに置き換えてから、クライアントを再起動します。args の値は変更しないでください。

既存のインストールに新しいツールが含まれていない場合

uvx はツール環境をキャッシュから再利用します。サポートされているインタープリターを使って、現在の PyPI リリースを解決するよう強制してから、MCP クライアントを再起動してください。

uvx --python 3.11 --refresh-package arxiv-mcp-server arxiv-mcp-server

それでもクライアントが古い環境を起動する場合は、args 配列の "arxiv-mcp-server" の前に "--python", "3.11" を追加してください。

コマンドの永続的なインストール

uvx 経由で起動する代わりに、arxiv-mcp-server を PATH に追加するには、次のようにします。

uv tool install arxiv-mcp-server

コマンドがすぐに使用できない場合は、uv tool update-shell を実行して、ターミナルを再起動してください。その後、"command": "arxiv-mcp-server" を使い、args からパッケージ名を省略します。

ツール

サーバーは現在、19 個のツールを公開しています。

研究アラート（watch_topic）

watch_topic でトピックの継続的な監視を保存し、list_watches で確認し、check_alerts で定期的にチェックし、unwatch_topic で削除します。

既存の監視対象（同じ topic 文字列）を更新する場合：

• categories を省略すると、保存済みのカテゴリフィルター（および変更しない他のフィールド）が維持されます。
• categories: [] を渡すと、カテゴリフィルターがクリアされます。
• 空ではないリストを渡すと、保存済みのフィルターが置き換えられます。

作成時の動作：categories を省略すると、空のリスト（カテゴリフィルターなし）が保存されます。

search_papers クエリガイド

ツールのスキーマは意図的に短くしています。クエリのチュートリアル、カテゴリ一覧、ワークフローの例については、常に読み込まれる MCP の説明ではなく、このセクションを参照してください。

クエリの構築

• 完全一致には引用符で囲んだフレーズを使います："multi-agent systems"、"neural networks"
• 関連する概念は OR で組み合わせます："AI agents" OR "software agents"
• フィールドを指定した検索：ti:"exact title phrase"、au:"author name"、abs:"keyword"、cat:cs.LG
• ANDNOT で除外します："machine learning" ANDNOT "survey"
• 長いキーワードリストより、主要な概念を 2～4 個使うことをおすすめします

高度なパターン

• フィールド＋フレーズ：ti:"transformer architecture"
• 複数のフィールド：au:"Smith" AND ti:"quantum"
• 除外："deep learning" ANDNOT ("survey" OR "review")
• 広い概念＋絞り込み："artificial intelligence" AND (robotics OR "computer vision")

カテゴリによる絞り込み（関連性を高めるために推奨）

コンピューターサイエンス：cs.AI（AI）、cs.LG（ML）、cs.CL（NLP）、cs.CV（ビジョン）、cs.MA（マルチエージェント）、cs.RO（ロボティクス）、cs.NE（ニューラル／進化的手法）、cs.IR（IR）、cs.HC（HCI）、cs.CR（セキュリティ）、cs.DB（データベース）

統計・数学：stat.ML、stat.AP、math.OC、math.ST

物理学ほか：quant-ph、eess.SP、eess.AS、physics.data-an

効果的な例

• categories: ["cs.LG", "cs.AI"] を指定した ti:"reinforcement learning"
• categories: ["cs.LG"] を指定した au:"Hinton" AND "deep learning"
• categories: ["cs.MA"] を指定した "multi-agent" ANDNOT "survey"
• categories: ["cs.CL"] を指定した abs:"transformer" AND ti:"attention"

日付と並べ替え

• 日付形式は YYYY-MM-DD です（date_from／date_to）
• デフォルトの sort_by は relevance です。新しい順に監視するには date を使います
• 基礎的な研究を検索する場合は、タイトル／要旨のフィールド検索とともに date_to: "2010-12-31" を指定します

結果件数、要旨、ページネーション

• デフォルトの max_results は 5 です（上限 50）。より多くの件数を取得するには、明示的な値を渡してください。
• abstract_mode：snippet（デフォルト。約 280 文字。省略時は … [truncated] と表示）、full（要旨全文）、または none（要旨を省略）。その他のメタデータ（タイトル、著者、カテゴリ、日付、URL）は常に返されます。
• レスポンスには total_results（コーパス内のヒット数）、returned、has_more、start、next_start、abstract_mode が含まれます
• 次のページを取得するには、同じ abstract_mode を指定して start=next_start を渡します
• arXiv はリクエストの間隔を約 3 秒空けるよう求めます（サーバー側で処理されます）。レート制限エラーが発生した場合は、約 60 秒待ってください

論文を検索して確認する

MCP クライアントに、次の内容で search_papers を呼び出すよう依頼します：

{
  "query": "\"Kolmogorov-Arnold Networks\"",
  "categories": ["cs.LG", "cs.AI"],
  "sort_by": "date"
}

デフォルトでは、要旨の抜粋付きで最大 5 件の簡潔な結果が返されます。検索レスポンスで要旨全文が必要な場合は "abstract_mode": "full" を使うか、簡潔な検索の後に単一の論文について get_abstract を呼び出してください：

{
  "paper_id": "2404.19756"
}

abstract_mode=full で既に返された論文について、get_abstract を再度呼び出さないでください。

全文をダウンロードして読む

download_paper を次の内容で呼び出します：

{
  "paper_id": "2404.19756"
}

max_chars を省略すると、上限付きの最初のチャンクが返されます（論文の文字数はデフォルトで 12,000 文字）。キャッシュ済みの論文はすぐに返されます。"force": true を渡すと、再ダウンロードしてローカルの Markdown ファイルとサイドカーを上書きします（HTML 抽出機能のバージョンが変わった場合も自動的に同じ処理が行われます）。

続いて、キャッシュ済みのコンテンツを read_paper でページ単位で読み取ります：

{
  "paper_id": "2404.19756",
  "start": 0
}

または、前のチャンクから読み取りを続けます：

{
  "paper_id": "2404.19756",
  "start": 12000
}

大容量コンテンツのレスポンスには、content_length、returned_chars、next_start、is_truncated、および（省略されている場合）次の呼び出し手順を示す next_retrieval が含まれます。読み取りを続けるには、次の呼び出しの start に next_start を渡します。デフォルトのチャンクサイズを変更するには、max_chars を明示的に指定します。以前の上限なしの論文全文レスポンスを利用するには、"return_full_text": true を指定します。

移行に関する注意 (デフォルトでコンテンツが制限されます)

以前は、download_paper / read_paper で max_chars を省略すると論文の全体が返されていました。このデフォルトは now 12,000 文字のチャンクに変更され、1 回の MCP ツール呼び出しでクライアントのコンテキストウィンドウがあふれることがなくなりました。

すでに max_chars を渡していたクライアントは変更ありません。max_chars の省略 = 全文という動作に依存していた呼び出し元だけが、return_full_text: true を追加するか、next_start でページングする必要があります。

セクションごとに元の LaTeX を読む

get_paper_latex を次のように呼び出します:

{
  "paper_id": "1706.03762"
}

list_paper_latex_sections でセクション構成の最初のページを取得します:

{
  "paper_id": "1706.03762",
  "start": 0,
  "max_sections": 100
}

次に、その構成の ID を使って get_paper_latex_section を呼び出します:

{
  "paper_id": "1706.03762",
  "section_id": "3.2",
  "max_chars": 12000
}

LaTeX アーカイブは、内容が返される前に検証され、サイズ制限が適用され、ローカルにキャッシュされます。

オプションの依存関係

必要な機能に合わせてインストールするバリアントを選択してください:

# Base server
uv tool install arxiv-mcp-server

# Base server plus PDF conversion
uv tool install "arxiv-mcp-server[pdf]"

# Base server plus local semantic search
uv tool install "arxiv-mcp-server[pro]"

基本ツールがすでにインストールされている場合は、選択したバリアントを再インストールします:

uv tool install --force "arxiv-mcp-server[pdf]"

pdf エクストラは、使用可能な arXiv HTML がない論文向けに pymupdf4llm と pymupdf-layout をインストールします。pro エクストラは semantic_search と reindex 用のローカル埋め込み依存関係を追加します。セマンティック検索は、設定されたストレージディレクトリにすでにダウンロードされた論文に対してのみ動作します。

PDF 変換が必要な古い論文については、PDF エクストラを付けてパッケージを実行します:

{
  "mcpServers": {
    "arxiv": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "--from",
        "arxiv-mcp-server[pdf]",
        "arxiv-mcp-server"
      ]
    }
  }
}

組み込みプロンプト

このサーバーは 7 つの MCP プロンプトワークフローを提供します。プロンプトの利用可否はクライアントによって異なります。サーバーはワークフローの指示を提供しますが、別のモデルを実行するわけではありません。

Streamable HTTP

stdio が実用的でないデプロイメント向け:

TRANSPORT=http HOST=127.0.0.1 PORT=8080 \
  uvx arxiv-mcp-server --storage-path /absolute/path/to/papers

PowerShell:

$env:TRANSPORT = "http"
$env:HOST = "127.0.0.1"
$env:PORT = "8080"
uvx arxiv-mcp-server --storage-path C:\absolute\path\to\papers

クライアントを次に接続します:

{
  "mcpServers": {
    "arxiv": {
      "type": "http",
      "url": "http://127.0.0.1:8080/mcp"
    }
  }
}

クラウドおよびロードバランサーのプローブは http://<host>:<port>/healthz に GET する必要があります。HTTP サーバーがリッスン状態になると、本文 ok とともに 200 を返します。別個の /ready チェックはありません。プロセスが起動していれば準備完了です。stdio トランスポートには HTTP エンドポイントがありません。

サーバーはデフォルトで 127.0.0.1 にバインドし、MCP DNS リバインディング保護を有効にします。リバースプロキシでサーバーを公開する場合は、プロセスをプライベートインターフェース上に保ち、上流で認証とネットワーク制御を提供してください。プロキシが転送するホストとオリジンの値には ALLOWED_HOSTS と ALLOWED_ORIGINS を使用してください。

設定

Pydantic の設定では、環境変数名の大文字と小文字は区別されません。--storage-path は環境設定ではなく、コマンドラインオプションです。

セキュリティ

論文のテキストと LaTeX は、信頼できない外部コンテンツです。論文には、AI クライアントに指示を無視させたり、無関係なツールを呼び出させたりすることを意図したテキストが含まれている場合があります。

• 論文内の指示を、信頼できるコマンドとして扱わないでください。
• シェル、ブラウザー、ファイルシステム、メッセージングツールには、クライアントの承認制御を使用してください。
• 外部アクションを実行する前に、生成された要約を確認してください。
• 上流で認証が提供されない限り、Streamable HTTP を非公開にしてください。

報告ポリシーと脅威の詳細については、SECURITY.md を参照してください。

開発

git clone https://github.com/blazickjp/arxiv-mcp-server.git
cd arxiv-mcp-server
uv sync --extra test --extra dev
uv run pytest
uv run black --check .

MCP クライアントから開発用チェックアウトを実行するには、次のコマンドを使用します。

{
  "mcpServers": {
    "arxiv-dev": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/arxiv-mcp-server",
        "run",
        "arxiv-mcp-server"
      ]
    }
  }
}

貢献を歓迎します。プルリクエストを作成する前に CONTRIBUTING.md を読み、再現可能なバグの報告や範囲を限定した機能提案には GitHub Issues を使用してください。

ライセンス

Apache License 2.0。LICENSE を参照してください。