Arxiv Semantic Search

arXiv 検索 MCP

AI アシスタントが arXiv API にクエリを送信できる、軽量なモデルコンテキストプロトコルサーバーです。強力な検索方法を 2 つ提供します。

• セマンティック検索：ベクトル埋め込みを使用してクエリの意味を理解します。ArxivSearchを利用しています。

  注：現在、セマンティック検索が対応している論文は、コンピューターサイエンス（cs.*）カテゴリのみです。

• キーワード検索：カテゴリ、日付範囲、フィールド指定検索など、複数のフィルターを使った構造化クエリに対応しています。

  注：arXiv のすべてのカテゴリの論文に対応しています。

必要条件

• Python 3.12 以降
• uv パッケージマネージャー（依存関係の解決および実行用）

はじめに

1. クローンして依存関係をインストールする

# Clone the repository
git clone https://github.com/icyclv/arxiv-semantic-search-mcp.git
cd arxiv-semantic-search-mcp

# Install all project dependencies listed in pyproject.toml
uv sync

2. サーバーをローカルで実行する

# Start the MCP server
uv run main.py

エディター／クライアントの設定

この MCP サーバーを AI アシスタントのツール（Claude Desktop、VS Code MCP 拡張機能など）で使用するには、次の設定を追加します。

{
  "mcpServers": {
    "arxiv-semantic-search": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/arxiv-semantic-search-mcp",  // Replace with actual path
        "run",
        "main.py"
      ]
    }
  }
}

注：/path/to/arxiv-semantic-search-mcp を、リポジトリをクローンした実際のパスに置き換えてください。

利用可能な関数

関数	説明
search_semantic	自然言語のクエリと埋め込みを使用して論文をセマンティック検索します
search_keyword	複数のフィルターを使った構造化キーワードクエリで論文を検索します
get_details	arXiv ID を指定して論文の詳細情報を取得します
get_categories	arXiv のカテゴリ一覧とその説明を取得します
get_current_time	指定した形式で現在のサーバー時刻を取得します

詳細なドキュメントと例については、src/server.py を参照してください。

使用例

セマンティック検索

# Search for papers about deep learning in computer vision
search_semantic(
    query="recent advances in vision transformers for medical image segmentation",
    categories=["cs.CV", "cs.AI"]
)

キーワード検索

# Search for recent machine learning papers in multiple categories
search_keyword(
    categories=["cs.AI", "cs.LG"],
    start_date="2024-01-01",
    all_fields="transformer",
    sort_by="submittedDate",
    sort_order="descending"
)

論文の詳細を取得

# Get detailed information for a specific paper
get_details("2401.00001")

ライセンス

このプロジェクトは MIT ライセンスのもとで公開されています。