APR

🚀 ArXiv MCP Server

🔍 シンプルなMCPインターフェースを通じて、AIアシスタントがarXivの論文を検索およびアクセスできるようにします。

ArXiv MCP Serverは、Model Context Protocol (MCP) を介してAIアシスタントとarXivの研究リポジトリの橋渡しを行います。これにより、AIモデルが論文を検索し、その内容にプログラムでアクセスすることができます。

✨ 主な機能

• 🔎 論文検索：日付範囲やカテゴリーのフィルターを使用してarXivの論文を検索できます。
• 📄 論文アクセス：論文の内容をダウンロードして閲覧できます。
• 📋 論文一覧：ダウンロードしたすべての論文を表示できます。
• 🗃️ ローカルストレージ：論文はローカルに保存され、高速なアクセスが可能です。
• 📝 プロンプト：一連の研究用プロンプトが用意されています。

🚀 クイックスタート

Smitheryを通じたインストール

Smithery を通じてClaude Desktop用のArXiv Serverを自動的にインストールするには、以下のコマンドを実行します。

npx -y @smithery/cli install arxiv-mcp-server --client claude

手動でのインストール

uvを使用してインストールします。

uv tool install arxiv-mcp-server

開発用にインストールする場合は、以下の手順を実行します。

# リポジトリをクローンし、開発環境をセットアップ
git clone https://github.com/blazickjp/arxiv-mcp-server.git
cd arxiv-mcp-server

# 仮想環境を作成してアクティブ化
uv venv
source .venv/bin/activate

# テスト依存関係を含めてインストール
uv pip install -e ".[test]"

🔌 MCP統合

MCPクライアントの設定ファイルに以下の設定を追加します。

{
    "mcpServers": {
        "arxiv-mcp-server": {
            "command": "uv",
            "args": [
                "tool",
                "run",
                "arxiv-mcp-server",
                "--storage-path", "/path/to/paper/storage"
            ]
        }
    }
}

開発用の設定は以下の通りです。

{
    "mcpServers": {
        "arxiv-mcp-server": {
            "command": "uv",
            "args": [
                "--directory",
                "path/to/cloned/arxiv-mcp-server",
                "run",
                "arxiv-mcp-server",
                "--storage-path", "/path/to/paper/storage"
            ]
        }
    }
}

💻 使用例

基本的な使用法

1. 論文検索

オプションのフィルターを使用して論文を検索します。

result = await call_tool("search_papers", {
    "query": "transformer architecture",
    "max_results": 10,
    "date_from": "2023-01-01",
    "categories": ["cs.AI", "cs.LG"]
})

2. 論文ダウンロード

arXiv IDを指定して論文をダウンロードします。

result = await call_tool("download_paper", {
    "paper_id": "2401.12345"
})

3. 論文一覧表示

ダウンロードしたすべての論文を表示します。

result = await call_tool("list_papers", {})

4. 論文読み取り

指定した論文の内容にアクセスします。

result = await call_tool("read_paper", {
    "paper_id": "2401.12345"
})

高度な使用法

論文分析プロンプト

論文IDのみを指定して学術論文を分析する包括的なワークフローです。

result = await call_prompt("deep-paper-analysis", {
    "paper_id": "2401.12345"
})

このプロンプトには以下の内容が含まれています。

• 利用可能なツール (list_papers, download_paper, read_paper, search_papers) の詳細な使用方法の説明
• 論文分析の体系的なワークフロー
• 包括的な分析構造で、以下の項目をカバーしています。
  • エグゼクティブサマリー
  • 研究背景
  • 方法論分析
  • 結果評価
  • 実践的および理論的な影響
  • 将来の研究方向
  • 広範な影響

⚙️ 設定

環境変数を使用して設定を行います。

🧪 テスト

テストスイートを実行するには、以下のコマンドを実行します。

python -m pytest

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。詳細はLICENSEファイルを参照してください。