medRxiv MCP Server

medRxiv MCP サーバー

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

medRxiv MCP サーバーは、Model Context Protocol（MCP）を介して AI アシスタントと medRxiv のプレプリントリポジトリをつなぎます。AI モデルがヘルスサイエンスのプレプリントを検索し、プログラムからその内容にアクセスできるようにします。

🤝 貢献する • 📝 バグを報告する

✨ 主な機能

• 🔎 論文検索：カスタム検索文字列や高度な検索パラメーターを使って medRxiv の論文を検索します ✅
• 🚀 効率的な取得：論文のメタデータに素早くアクセスできます ✅
• 📊 メタデータへのアクセス：DOI を使って特定の論文の詳細なメタデータを取得します ✅
• 📊 研究支援：ヘルスサイエンスの研究と分析を支援します ✅
• 📄 論文へのアクセス：論文の内容をダウンロードして閲覧します 📝
• 📋 論文の一覧表示：ダウンロード済みのすべての論文を表示します 📝
• 🗃️ ローカルストレージ：論文をローカルに保存し、すばやくアクセスできるようにします 📝
• 📝 研究プロンプト：論文分析に特化したプロンプト一式を提供します 📝

🚀 クイックスタート

Smithery 経由でインストールする

Smithery 経由で、Claude Desktop 用の medRxiv Server を自動的にインストールします。

claude

npx -y @smithery/cli@latest install @JackKuo666/medrxiv-mcp-server --client claude --config "{}"

Cursor

次の内容を Settings → Cursor Settings → MCP → Add new server に貼り付けます。

• Mac/Linux

npx -y @smithery/cli@latest run @JackKuo666/medrxiv-mcp-server --client cursor --config "{}" 

Windsurf

npx -y @smithery/cli@latest install @JackKuo666/medrxiv-mcp-server --client windsurf --config "{}"

CLine

npx -y @smithery/cli@latest install @JackKuo666/medrxiv-mcp-server --client cline --config "{}"

手動でインストールする

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

uv tool install medRxiv-mcp-server

開発用：

# Clone and set up development environment
git clone https://github.com/JackKuo666/medRxiv-MCP-Server.git
cd medRxiv-MCP-Server

# Create and activate virtual environment
uv venv
source .venv/bin/activate
uv pip install -r requirements.txt

📊 使用方法

MCP サーバーを起動します。

python medrxiv_server.py

サーバーの起動後、AI アシスタントまたはアプリケーションで提供される MCP ツールを使用できます。ツールの使用例を以下に示します。

例 1：キーワードで論文を検索する

result = await mcp.use_tool("search_medrxiv_key_words", {
    "key_words": "COVID-19 vaccine efficacy",
    "num_results": 5
})
print(result)

例 2：高度な検索を実行する

result = await mcp.use_tool("search_medrxiv_advanced", {
    "term": "COVID-19",
    "author1": "MacLachlan",
    "start_date": "2020-01-01",
    "end_date": "2023-12-31",
    "num_results": 3
})
print(result)

例 3：特定の論文のメタデータを取得する

result = await mcp.use_tool("get_medrxiv_metadata", {
    "doi": "10.1101/2025.03.09.25323517"
})
print(result)

これらの例では、medRxiv MCP サーバーが提供する 3 つの主要なツールの使い方を示しています。用途に応じてパラメーターを調整してください。

🛠 MCP ツール

medRxiv MCP サーバーは、次のツールを提供します。

search_medrxiv_key_words

キーワードを使って medRxiv の論文を検索します。

パラメーター：

• key_words (str)：検索クエリ文字列
• num_results (int, optional)：返す検索結果の数（デフォルト：10）

戻り値： 論文情報を含む辞書のリスト

search_medrxiv_advanced

medRxiv の論文を高度な条件で検索します。

パラメーター：

• term (str, optional)：一般的な検索語
• title (str, optional)：タイトルを検索
• author1 (str, optional)：第 1 著者
• author2 (str, optional)：第 2 著者
• abstract_title (str, optional)：抄録とタイトルを検索
• text_abstract_title (str, optional)：全文、抄録、タイトルを検索
• section (str, optional)：medRxiv のセクション
• start_date (str, optional)：検索範囲の開始日（形式：YYYY-MM-DD）
• end_date (str, optional)：検索範囲の終了日（形式：YYYY-MM-DD）
• num_results (int, optional)：返す検索結果の数（デフォルト：10）

戻り値： 論文情報を含む辞書のリスト

get_medrxiv_metadata

DOI を使って medRxiv の論文のメタデータを取得します。

パラメーター：

• doi (str)：論文の DOI

戻り値： 論文のメタデータを含む辞書

Claude Desktop での使用方法

次の設定を claude_desktop_config.json に追加します。

（Mac OS）

{
  "mcpServers": {
    "medrxiv": {
      "command": "python",
      "args": ["-m", "medrxiv-mcp-server"]
      }
  }
}

（Windows 版）：

{
  "mcpServers": {
    "medrxiv": {
      "command": "C:\\Users\\YOUR_USERNAME\\AppData\\Local\\Programs\\Python\\Python311\\python.exe",
      "args": [
        "-m",
        "medrxiv-mcp-server"
      ]
    }
  }
}

Cline での使用方法

{
  "mcpServers": {
    "medrxiv": {
      "command": "bash",
      "args": [
        "-c",
        "source /home/YOUR/PATH/mcp-server-medRxiv/.venv/bin/activate && python /home/YOUR/PATH/mcp-server-medRxiv/medrxiv_server.py"
      ],
      "env": {},
      "disabled": false,
      "autoApprove": []
    }
  }
}

Claude Desktop を再起動すると、次の機能を利用できるようになります。

論文の検索

次のようなクエリを使って、Claude に論文の検索を依頼できます。

Can you search medRxiv for recent papers about genomics?

検索結果には、一致した論文の基本情報が含まれます。

• 論文タイトル

• 著者

• DOI

論文の詳細を取得する

DOI がわかったら、詳細情報を取得できます。

Can you show me the details for paper 10.1101/003541?

次の情報が返されます。

• 論文の正式なタイトル

• 著者

• 公開日

• 論文の要旨

• 利用可能な形式へのリンク（PDF/HTML）

📝 TODO

download_paper

論文をダウンロードして、ローカルに保存します。

read_paper

ダウンロードした論文の内容を読み取ります。

list_papers

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

📝 研究用プロンプト

サーバーには、学術論文の分析を支援する専門的なプロンプトが用意されています。

論文分析プロンプト

論文 ID だけで利用できる、学術論文を分析するための包括的なワークフローです。

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

このプロンプトには、次の内容が含まれます。

• 利用可能なツール（list_papers、download_paper、read_paper、search_papers）の使用に関する詳細な手順
• 論文分析の体系的なワークフロー
• 次の項目を網羅する包括的な分析構成：
  • エグゼクティブサマリー
  • 研究の背景
  • 方法論の分析
  • 結果の評価
  • 実践的および理論的な示唆
  • 今後の研究の方向性
  • より広範な影響

📁 プロジェクト構成

• medrxiv_server.py：FastMCP を使用した MCP サーバーのメイン実装
• medrxiv_web_search.py：medRxiv の検索用ウェブスクレイピングロジック

🔧 依存関係

• Python 3.10+
• FastMCP
• asyncio
• logging
• requests（ウェブスクレイピング用。medrxiv_web_search.py で使用）
• beautifulsoup4（ウェブスクレイピング用。medrxiv_web_search.py で使用）

次のコマンドで、必要な依存関係をインストールできます。

pip install FastMCP requests beautifulsoup4

🤝 貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。

📄 ライセンス

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

🙏 謝辞

このプロジェクトは、arxiv-mcp-server プロジェクトの取り組みに触発され、その成果を基盤として構築されています。

⚠️ 免責事項

このツールは研究目的でのみ使用してください。medRxiv の利用規約を遵守し、責任を持って使用してください。