📚 arXiv MCP Server

Model Context Protocol を通じて、世界最大の学術論文リポジトリにアクセスできます

AI アシスタントを arXiv の膨大な学術論文コレクションに接続する、シンプルなModel Context Protocolサーバーです。AI ワークフローから直接、研究論文の検索、分析、ダウンロードができます。

🚀 クイックスタート

前提条件

• Python 3.12+
• uv パッケージマネージャー

インストール

オプション 1：Docker（推奨）

# Pull and run the Docker image
docker run --rm -it ghcr.io/tejas242/arxiv-mcp:latest

# Or using docker-compose
git clone https://github.com/tejas242/arxiv-mcp.git
cd arxiv-mcp
docker compose up

オプション 2：ローカル開発

# Clone and setup
git clone https://github.com/tejas242/arxiv-mcp.git
cd arxiv-mcp
uv sync

# Test the server
uv run main.py

🛠️ 利用可能な関数

関数の詳細

✅ 完全に動作する関数

search_papers - 主な検索関数

• arXiv の完全なクエリ構文に対応
• キーワード、著者、カテゴリ、タイトルを処理
• 並べ替えとページネーションを設定可能
• 要約とリンクを含む形式で結果を返します

get_paper_details - 論文の詳細情報

• メタデータを完全に抽出
• 所属機関を含む著者情報
• カテゴリ分類とリンク
• 公開日と更新日

build_advanced_query - クエリ構築ヘルパー

• 複数の検索条件を組み合わせます
• タイトル、著者、カテゴリ、要約での検索に対応
• 適切な形式のクエリ文字列を返します

get_arxiv_categories - カテゴリの参照

• arXiv の分野カテゴリをすべて一覧表示
• 各カテゴリの説明
• 対象を絞った検索クエリの作成に役立ちます

⚠️ 機能に制限があります（回避策あり）

search_by_author - 代わりに search_papers('au:"Author Name"') を使用してください search_by_category - 代わりに search_papers('cat:category_code') を使用してください

🔧 修正が必要な機能

download_paper_pdf - HTTP リダイレクト処理の改善が必要です

• 現在、HTTPS/HTTP リダイレクトの問題により失敗します
• PDF は、検索結果に表示されるリンクから直接アクセスできます

⚙️ 設定

Claude Desktop のセットアップ

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

{
  "mcpServers": {
    "arxiv-mcp": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "ghcr.io/tejas242/arxiv-mcp:latest"
      ]
    }
  }
}

VS Code MCP 拡張機能

{
  "mcp": {
    "servers": {
      "arxiv-mcp": {
        "command": "uv",
        "args": ["--directory", "/path/to/arxiv-mcp", "run", "main.py"]
      }
    }
  }
}

💡 使用例

基本的な検索操作

# Search for papers about transformers
search_papers("transformer architecture")

# Advanced query with specific fields
search_papers('ti:"attention mechanism" AND cat:cs.LG')

# Author-specific search (recommended approach)
search_papers('au:"Geoffrey Hinton"')

# Category browsing (recommended approach)
search_papers('cat:cs.AI')

研究ワークフロー

# 1. Find the famous "Attention" paper
search_papers('ti:"Attention Is All You Need"')
get_paper_details("1706.03762")

# 2. Explore related work
search_papers("transformer neural networks")

# 3. Build complex queries
query = build_advanced_query(
    title_keywords="few-shot learning",
    author_name="Tom Brown",
    category="cs.LG"
)
search_papers(query)

📊 arXiv カテゴリーリファレンス

利用可能なカテゴリーの全一覧を確認するには、get_arxiv_categories() を使用してください。

🧪 テスト結果

すべての機能を包括的にテストした結果：

✅ 信頼性の高い機能

• キーワード、著者、カテゴリーによる論文検索：成功率 100%
• 論文の詳細取得：完全なメタデータの抽出が動作します
• クエリの構築：すべての構文の組み合わせに対応しています
• カテゴリー一覧：すべての arXiv カテゴリーにアクセスできます

⚠️ 代替方法の推奨

• 著者検索：search_by_author() の代わりに search_papers('au:"Author Name"') を使用してください
• カテゴリーの参照：search_by_category() の代わりに search_papers('cat:category') を使用してください

🔧 既知の問題

• PDF のダウンロード：リダイレクト処理の改善が必要です（PDF は直接リンクからアクセスできます）

🔧 開発

プロジェクト構成

arxiv-mcp/
├── src/arxiv_mcp/          # Main package
│   ├── server.py           # MCP server implementation
│   ├── arxiv_client.py     # arXiv API wrapper
│   ├── models.py           # Pydantic data models
│   └── utils.py            # Helper functions
├── tests/                  # Test suite
├── main.py                 # Entry point
└── pyproject.toml         # Project config

テストの実行

uv run pytest tests/ -v

デバッグモード

# Enable detailed logging
PYTHONPATH=src uv run python -c "
import logging
logging.basicConfig(level=logging.DEBUG)
from arxiv_mcp.server import main
main()
"

⚠️ トラブルシューティング

• arXiv
• Model Context Protocol