blazickjp/arxiv-mcp-server

arxiv‑mcp‑server – arXiv論文の閲覧・整理のためのローカルMCPツール

概要 – Model Context Protocol (MCP)を話す、Pythonベースの小さなサーバーです。ローカルで実行され（uvxまたは通常のコマンドとして）、AIアシスタント/エージェントがarXivを検索し、論文をダウンロードし、セクションごとに（レンダリングされたMarkdown版と元のLaTeXの両方で）読み、BibTeX引用を保持し、新しい論文が登場したときに通知するトピックウォッチを設定できる「ツール」セットを公開します。このサーバーはモデルをホストしません。既に言語モデルを持つクライアントにデータを提供するだけです。

主な機能

機能	使用方法	得られるもの
arXiv検索 (search_papers)	クエリ、オプションのカテゴリ、日付範囲、並べ替えを指定	最大5件の簡潔な結果（タイトル、著者、スニペット） – ページングと完全な要約のリクエストが可能
ダウンロードと閲覧 (download_paper, read_paper)	arXiv IDを指定; サーバーがHTML→Markdown（PDFフォールバック）を取得し、ローカルに保存	論文の制限付きチャンク（デフォルト12,000文字）とページング情報。全文は明示的にリクエスト可能
セクションレベルのアクセス (get_paper_outline, read_paper_section)	最初にアウトラインを要求し、次に特定の見出しIDを要求	単一セクションの正確なMarkdown。ステップバイステップの分析に役立ちます
元のLaTeX (get_paper_latex, list_paper_latex_sections, get_paper_latex_section)	Markdownと同じフローですが、著者が提出したLaTeXソースを取得	制限付きLaTeXスニペット。正確な方程式やマクロが必要な場合に便利
引用処理 (citation_graph, export_citations)	論文の参考文献と引用文献（Semantic Scholar）を照会するか、BibTeXをエクスポート	小さな引用グラフと貼り付け可能なBibTeXエントリ
トピックウォッチ (watch_topic, check_alerts, …)	キーワードとオプションのarXivカテゴリを保存; サーバーは最後にチェックしたタイムスタンプを記録	check_alertsを呼び出すと、ウォッチに一致する新しい論文が返されます
セマンティック検索 (semantic_search, reindex) – proエクストラ	論文をダウンロードした後、ローカルの埋め込みインデックスを実行して意味で検索	arXivに連絡せずに類似論文を発見; オプションのproエクストラが必要

実行方法

• 最も簡単 – uvx arxiv-mcp-server。uvxは分離環境を作成し、PyPIからパッケージをダウンロードし（arxiv-mcp-server==0.8.2）、stdioでサーバーを起動します。
• PATHに永続的に – uv tool install arxiv-mcp-server（または[pdf] / [pro]エクストラを追加）。
• HTTPモード – TRANSPORT=httpとHOST/PORT環境変数を設定; クライアントはhttp://host:port/mcpに接続します。

クライアント統合 READMEには、さまざまなMCP対応ツール（Claude Code、OpenAI Codex、Hermes Agent、VS Code/Kiro、Claude Desktop）向けの既製のJSONスニペットが含まれています。このスニペットは、クライアントにuvx（またはインストール済みバイナリ）でサーバーを起動し、オプションでカスタムストレージディレクトリ（デフォルトでは~/.arxiv-mcp-server/papers）を指定します。

なぜ単なる検索ラッパーではないのか このサーバーは、検索や引用グラフの構築という重い処理を実行しません。これらの呼び出しは、公式のarXiv API、Semantic Scholarなどに送られます。あなたのマシンに残るのは文献ループです – 論文のダウンロード、ローカルのMarkdown/LaTeXコピーの保持、アウトラインの抽出、ウォッチの管理。これにより、LLMが実際に目にするデータを制御し、大きなPDFをモデルのコンテキストに繰り返し取り込むことを回避できます。

誰が恩恵を受けるか

• LLMアシスタントを使用して新しいトピックを調査し、アシスタントにオンデマンドで実際の論文を取得させたい研究者や学生。
• 独自のarXivスクレーパーを構築せずに、信頼できるローカルな学術コンテンツソースを必要とするカスタムAIエージェントを開発する開発者。
• 再現可能な引用データ（BibTeX）とソースから直接LaTeXセクションを読みたい人。

インストールの落とし穴

• パッケージはPyPIのみで公開されています。同じ名前の無関係なnpmパッケージが存在します – npmでインストールしないでください。
• macOS/Windows GUIアプリではPATHがターミナルと異なる場合があります。`を置き換える必要があるかもしれません。