adamamer20-paper-search-mcp-openai

Paper Search MCP

arXiv、PubMed、bioRxiv、Sci-Hub（オプション）など、複数のソースから学術論文を検索・ダウンロードするための Model Context Protocol（MCP）サーバーです。Claude Desktop などの大規模言語モデルとのシームレスな連携を目的に設計されています。

---

目次

• 概要
• 機能
• インストール
  • クイックスタート
    • パッケージのインストール
    • Claude Desktop の設定
  • 開発向け
    • 環境のセットアップ
    • 依存関係のインストール
• コントリビューション
• デモ
• ライセンス
• TODO

---

概要

paper-search-mcp は、さまざまなプラットフォームから学術論文を検索・ダウンロードできる Python ベースの MCP サーバーです。論文を検索するツール（例：search_arxiv）や PDF をダウンロードするツール（例：download_arxiv）を提供するため、研究者や AI 主導のワークフローに最適です。MCP Python SDK を使用して構築されており、Claude Desktop などの LLM クライアントとシームレスに連携します。

---

機能

• 複数のソースに対応：arXiv、PubMed、bioRxiv、medRxiv、Google Scholar、IACR ePrint Archive、Semantic Scholar から論文を検索・ダウンロードできます。
• Deep Research に対応：OpenAI Deep Research および ChatGPT コネクターで必要とされる、標準化された search ツールと fetch ツールを提供します。
• 出力の標準化：論文は Paper クラスを介して、一貫性のある辞書形式で返されます。
• 非同期ツール：httpx を使用してネットワークリクエストを効率的に処理します。
• MCP 連携：LLM のコンテキストを強化するため、MCP クライアントと互換性があります。
• 拡張しやすい設計：academic_platforms モジュールを拡張することで、新しい学術プラットフォームを簡単に追加できます。

---

インストール

paper-search-mcp は uv または pip を使用してインストールできます。すぐに利用するためのクイックスタートと、開発向けの詳細なセットアップ方法を以下に示します。

Smithery 経由でのインストール

Smithery 経由で Claude Desktop 用の paper-search-mcp を自動的にインストールするには：

npx -y @smithery/cli install @openags/paper-search-mcp --client claude

クイックスタート

サーバーをすぐに実行したい場合：

1. パッケージをインストール：

   uv add paper-search-mcp
   

2. Claude Desktop を設定： この設定を ~/Library/Application Support/Claude/claude_desktop_config.json（Mac）または %APPDATA%\Claude\claude_desktop_config.json（Windows）に追加します：

   {
     "mcpServers": {
       "paper_search_server": {
         "command": "uv",
         "args": [
           "run",
           "--directory",
           "/path/to/your/paper-search-mcp",
           "-m",
           "paper_search_mcp.server"
         ],
         "env": {
           "SEMANTIC_SCHOLAR_API_KEY": "" // Optional: For enhanced Semantic Scholar features
         }
       }
     }
   }
   

   注：/path/to/your/paper-search-mcp を実際のインストールパスに置き換えてください。

開発向け

コードを変更したり、コントリビューションしたりしたい開発者向け：

1. 環境をセットアップ：

   # Install uv if not installed
   curl -LsSf https://astral.sh/uv/install.sh | sh
   
   # Clone repository
   git clone https://github.com/openags/paper-search-mcp.git
   cd paper-search-mcp
   
   # Create and activate virtual environment
   uv venv
   source .venv/bin/activate  # On Windows: .venv\Scripts\activate
   

2. 依存関係をインストール：

   # Install project in editable mode
   uv add -e .
   
   # Add development dependencies (optional)
   uv add pytest flake8
   

---

コントリビューション

コントリビューションを歓迎します！始めるには、次の手順に従ってください。

1. リポジトリをフォーク： GitHub で「Fork」をクリックします。

2. クローンしてセットアップ：

   git clone https://github.com/yourusername/paper-search-mcp.git
   cd paper-search-mcp
   pip install -e ".[dev]"  # Install dev dependencies (if added to pyproject.toml)
   

3. 変更を加える：

   • academic_platforms/ に新しいプラットフォームを追加します。
   • tests/ のテストを更新します。

4. プルリクエストを送信： 変更をプッシュし、GitHub で PR を作成します。

---

デモ

TODO

対応予定の学術プラットフォーム

• [√] arXiv
• [√] PubMed
• [√] bioRxiv
• [√] medRxiv
• [√] Google Scholar
• [√] IACR ePrint Archive
• [√] Semantic Scholar
• PubMed Central (PMC)
• Science Direct
• Springer Link
• IEEE Xplore
• ACM Digital Library
• Web of Science
• Scopus
• JSTOR
• ResearchGate
• CORE
• Microsoft Academic

---

ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳細については LICENSE ファイルをご覧ください。

---

paper-search-mcp で楽しくリサーチしてください！問題が発生した場合は、GitHub issue を作成してください。