Arxiv MCP Server

🚀 arXiv MCP Server

このサーバーは、Model Context Protocol (MCP) を利用して、自然言語でarXiv APIとやり取りできるようにするものです。

🚀 クイックスタート

このサーバーを使用することで、arXiv.orgにホストされている学術論文に関するさまざまな操作が可能になります。

✨ 主な機能

• 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): 返す最初の結果のインデックス

📦 インストール

手動インストール

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

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

uv パッケージマネージャーをインストールします。他のオペレーティングシステムでのインストールの詳細については、公式uvドキュメント を参照してください。

# macOSの場合はHomebrewを使用
brew install uv

# または
curl -LsSf https://astral.sh/uv/install.sh | sh

仮想環境を作成してアクティブ化します。

uv venv --python=python3.13
source .venv/bin/activate   # Windowsの場合は `venv\Scripts\activate`

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

uv sync

💻 使用例

Claude Desktopでの使用

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

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/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 を参照してください。