Skip to main content
Glama

ArXiv-MCP

by kelvingao
MIT License
  • Linux
  • Apple

AI エージェントが、電子プレプリントの人気のオープン アクセス リポジトリであるarXivから学術論文を検索、取得、分析できるようにするモデル コンテキスト プロトコル (MCP)サーバーの実装。

概要

このプロジェクトは、AIエージェントがarXivリポジトリと対話し、キーワードに基づいて論文を検索したり、特定の論文に関する詳細情報を取得したり、さらには論文の内容を抽出・分析したりすることを可能にするMCPサーバーを提供します。これは、研究支援のための実用的なツールであると同時に、MCPサーバー構築のためのリファレンス実装としても機能します。

この実装は、MCP サーバーの構築に関するベスト プラクティスに従っており、MCP 互換のあらゆるクライアントとのシームレスな統合を可能にします。

特徴

サーバーは学術研究のための強力なツールをいくつか提供します。

  1. search_papers : キーワードを使ってarXivで論文を検索し、包括的な要約を取得します
  2. get_paper_details : arXiv IDで特定の論文の詳細情報を取得する
  3. extract_paper_content : 論文の PDF から全文コンテンツをダウンロードして抽出します
  4. analyze_paper : 論文の内容を分析し、包括的な要約を生成する

前提条件

  • Python 3.11以上
  • MCP サーバーをコンテナとして実行する場合は Docker (推奨)

インストール

UVの使用

  1. uv がインストールされていない場合はインストールします。
    pip install uv
  2. このリポジトリをクローンします:
    git clone https://github.com/kelvingao/arxiv-mcp.git cd arxiv-mcp
  3. 依存関係をインストールします:
    uv pip install -e .
  4. .env.exampleに基づいて.envファイルを作成します。
    cp .env.example .env
  5. .envファイルで環境変数を設定します(構成セクションを参照)。

Dockerの使用(推奨)

  1. Docker イメージをビルドします。
    docker build -t mcp/arxiv --build-arg PORT=8050 .
  2. .env.exampleに基づいて.envファイルを作成し、環境変数を設定します。

構成

.envファイルでは次の環境変数を設定できます。

変数説明
TRANSPORTトランスポートプロトコル(sse または stdio)sse
HOSTSSEトランスポートを使用するときにバインドするホスト0.0.0.0
PORTSSE トランスポートを使用するときにリッスンするポート8050

サーバーの実行

UVの使用

SSEトランスポート
# Set TRANSPORT=sse in .env then: python src/server.py

MCP サーバーは、以下に示す構成で接続できる API エンドポイントとして実行されます。

Stdioトランスポート

stdio を使用すると、MCP クライアント自体が MCP サーバーを起動できるため、この時点では何も実行されません。

Dockerの使用

SSEトランスポート
docker run --env-file .env -p 8050:8050 mcp/arxiv

MCP サーバーは、以下に示す構成で接続できるコンテナー内の API エンドポイントとして実行されます。

Stdioトランスポート

stdio を使用すると、MCP クライアント自体が MCP サーバー コンテナーを起動できるため、この時点では何も実行されません。

MCPクライアントとの統合

SSE構成

SSE トランスポートを使用してサーバーを実行したら、次の構成を使用してサーバーに接続できます。

{ "mcpServers": { "arxiv": { "transport": "sse", "url": "http://localhost:8050/sse" } } }

Windsurf ユーザーへの注意: 設定ではurlの代わりにserverUrlを使用してください。

{ "mcpServers": { "arxiv": { "transport": "sse", "serverUrl": "http://localhost:8050/sse" } } }

n8n ユーザーへの注意: n8n は自身のコンテナの外部にあるホスト マシンにアクセスする必要のあるため、localhost ではなく host.docker.internal を使用してください。

したがって、MCP ノードの完全な URL は次のようになります: http://host.docker.internal:8050/sse

デフォルトの 8050 以外の値を使用している場合は、必ずポートを更新してください。

Python と Stdio 設定

このサーバーを、Claude Desktop、Windsurf、またはその他の MCP クライアントの MCP 構成に追加します。

{ "mcpServers": { "arxiv": { "command": "your/path/to/arxiv-mcp/.venv/bin/python", "args": ["your/path/to/arxiv-mcp/src/main.py"], "env": { "TRANSPORT": "stdio" } } } }

Stdio 構成の Docker

{ "mcpServers": { "arxiv": { "command": "docker", "args": ["run", "--rm", "-i", "-e", "TRANSPORT", "mcp/arxiv"], "env": { "TRANSPORT": "stdio" } } } }

使用例

AI エージェントで arXiv MCP サーバーを使用する方法の例をいくつか示します。

論文の検索

Find recent papers about quantum computing published in the last year.

論文の詳細を取得する

Get details for the paper with arXiv ID 2303.08774

紙のコンテンツの抽出

Extract the full text from the paper with arXiv ID 2303.08774

論文の分析

Analyze the methodology section of the paper with arXiv ID 2303.08774

独自のMCPサーバーの構築

この実装は、より複雑なMCPサーバーを構築するための基盤を提供します。独自のサーバーを構築するには、以下の手順に従ってください。

  1. @mcp.tool()デコレータを使用してメソッドを作成し、独自のツールを追加します。
  2. 独自のライフスパン関数を作成して、独自の依存関係 (クライアント、データベース接続など) を追加します。
  3. 既存のツールを変更したり、新しいツールを追加して機能を強化します
  4. @mcp.resource()@mcp.prompt()を使用してプロンプトとリソースを追加します。

ライセンス

MITライセンス

謝辞

-
security - not tested
A
license - permissive license
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

AI エージェントが arXiv から学術論文を検索、取得、分析できるようにするモデル コンテキスト プロトコル サーバー。キーワード検索、論文詳細の取得、コンテンツの抽出、論文分析などの機能をサポートします。

  1. 特徴
    1. 前提条件
      1. インストール
        1. UVの使用
        2. Dockerの使用(推奨)
      2. 構成
        1. サーバーの実行
          1. UVの使用
          2. Dockerの使用
        2. MCPクライアントとの統合
          1. SSE構成
          2. Python と Stdio 設定
          3. Stdio 構成の Docker
        3. 使用例
          1. 論文の検索
          2. 論文の詳細を取得する
          3. 紙のコンテンツの抽出
          4. 論文の分析
        4. 独自のMCPサーバーの構築
          1. ライセンス
            1. 謝辞

              Related MCP Servers

              • A
                security
                A
                license
                A
                quality
                The ArXiv MCP Server bridges the gap between AI models and academic research by providing a sophisticated interface to arXiv's extensive research repository. This server enables AI assistants to perform precise paper searches and access full paper content, enhancing their ability to engage with scientific literature.
                Last updated -
                4
                1,218
                Python
                Apache 2.0
                • Linux
                • Apple
              • A
                security
                A
                license
                A
                quality
                Enables real-time search and retrieval of academic paper information from multiple sources, providing access to paper metadata, abstracts, and full-text content when available, with structured data responses for integration with AI models that support tool/function calling.
                Last updated -
                3
                11
                Python
                AGPL 3.0
              • A
                security
                A
                license
                A
                quality
                Enables AI assistants to search and access arXiv research papers through a simple Message Control Protocol interface, allowing for paper search, download, listing, and reading capabilities.
                Last updated -
                4
                1
                Python
                Apache 2.0
              • -
                security
                A
                license
                -
                quality
                Enables AI assistants to search, download, and read arXiv research papers through a Message Control Protocol interface, with support for paper filtering and local storage.
                Last updated -
                Apache 2.0

              View all related MCP servers

              MCP directory API

              We provide all the information about MCP servers via our MCP API.

              curl -X GET 'https://glama.ai/api/mcp/v1/servers/kelvingao/arxiv-mcp'

              If you have feedback or need assistance with the MCP directory API, please join our Discord server