arXiv MCP Server

arXiv MCP サーバー

自然言語を使って arXiv API とやり取りできる、Model Context Protocol（MCP）サーバーです。

機能

• arXiv.org で公開されている学術論文のメタデータを取得します
• 論文を PDF 形式でローカルマシンにダウンロードします
• arXiv データベースを指定したクエリで検索します
• 論文を取得し、LLM のコンテキストに読み込みます

ツール

• get_article_url
  • arXiv.org で公開されている論文のタイトルをもとに、論文の URL を取得します
    • title (String)：論文のタイトル
• download_article
  • arXiv.org で公開されている論文を PDF ファイルとしてダウンロードします
    • title (String)：論文のタイトル
• load_article_to_context
  • arXiv.org で公開されている論文を LLM のコンテキストに読み込みます
    • title (String)：論文のタイトル
• get_details
  • arXiv.org で公開されている論文のタイトルをもとに、メタデータを取得します
    • title (String)：論文のタイトル
• search_arxiv
  • 指定されたパラメーターに基づいて arXiv API を検索し、一致する論文のメタデータを返します
    • all_fields (String)：すべてのメタデータフィールドを対象とした一般的なキーワード検索
    • title (String)：論文のタイトル内で検索するキーワード
    • author (String)：結果を絞り込む著者名
    • abstract (String)：論文の要旨内で検索するキーワード
    • start (int)：返す最初の結果のインデックス

セットアップ

MacOS

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

git clone https://github.com/prashalruchiranga/arxiv-mcp-server.git
cd arxiv-mcp-server

uv パッケージマネージャーをインストールします。インストール方法の詳細は、uv の公式ドキュメントをご覧ください。

# Using Homebrew
brew install uv

# or
curl -LsSf https://astral.sh/uv/install.sh | sh

仮想環境を作成して有効化します。

uv venv --python=python3.13
source .venv/bin/activate

開発用の依存関係をインストールします。

uv sync

Windows

uv パッケージマネージャーをインストールします。インストール方法の詳細は、uv の公式ドキュメントをご覧ください。

# Use irm to download the script and execute it with iex
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

シェルを閉じて再度開き、リポジトリをクローンします。

git clone https://github.com/prashalruchiranga/arxiv-mcp-server.git
cd arxiv-mcp-server

仮想環境を作成して有効化します。

uv venv --python=python3.13
source .venv\Scripts\activate

開発用の依存関係をインストールします。

uv sync

Claude Desktop での使用

この連携を有効にするには、サーバーの設定を claude_desktop_config.json ファイルに追加します。ファイルが存在しない場合は、作成してください。

MacOS の場合：~/Library/Application Support/Claude/claude_desktop_config.json Windows の場合：%APPDATA%/Roaming/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "arxiv-server": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/PARENT/FOLDER/arxiv-mcp-server/src/arxiv_server",
        "run",
        "server.py"
      ],
      "env": {
        "DOWNLOAD_PATH": "/ABSOLUTE/PATH/TO/DOWNLOADS/FOLDER"
      }
    }
  }
}

コマンドフィールドに uv の実行ファイルのフルパスを指定する必要がある場合があります。MacOS では which uv、Windows では where uv を実行すると確認できます。

プロンプトの例

Can you get the details of 'Reasoning to Learn from Latent Thoughts' paper?

Get the papers authored or co-authored by Yann Lecun on convolutional neural networks

Download the attention is all you need paper

Can you get the papers by Andrew NG which have 'convolutional neural networks' in title?

Can you display the paper?

List the titles of papers by Yann LeCun. Paginate through the API until there are 30 titles

ライセンス

MIT ライセンスのもとで公開されています。LICENSEをご覧ください。