medRxiv-MCP-Server

by JackKuo666
Verified

Integrations

  • Inspired by and built upon the work done in the arxiv-mcp-server project, suggesting similar functionality to access academic preprints.

  • Enables retrieving detailed metadata for specific scientific papers using their DOI identifiers through the get_medrxiv_metadata tool.

medRxiv MCP サーバー

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

medRxiv MCPサーバーは、モデルコンテキストプロトコル(MCP)を介して、AIアシスタントとmedRxivのプレプリントリポジトリ間の橋渡しを提供します。これにより、AIモデルはプログラム的に健康科学分野のプレプリントを検索し、そのコンテンツにアクセスできるようになります。

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

✨ コア機能

  • 🔎 論文検索: カスタム検索文字列または高度な検索パラメータを使用して medRxiv 論文を検索します ✅
  • 🚀 効率的な検索: 論文のメタデータへの高速アクセス ✅
  • 📊 メタデータアクセス: DOI を使用して特定の論文の詳細なメタデータを取得します ✅
  • 📊 研究支援:健康科学の研究と分析を促進する ✅
  • 📄 論文アクセス: 論文コンテンツをダウンロードして読む 📝
  • 📋 論文リスト: ダウンロードしたすべての論文を表示 📝
  • 🗃️ ローカルストレージ: 論文はローカルに保存され、より高速にアクセスできるようになります 📝
  • 📝 研究プロンプト: 論文分析のための専門的なプロンプトのセット 📝

🚀 クイックスタート

Smithery経由でインストール

Smithery経由で Claude Desktop 用の medRxiv Server を自動的にインストールするには:

クロード

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

カーソル

次の内容を「設定」→「カーソル設定」→「MCP」→「新しいサーバーの追加」に貼り付けます。

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

ウィンドサーフィン

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

Cライン

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 サーバーは次のツールを提供します。

検索_medrxiv_キーワード

キーワードを使用してmedRxivの記事を検索します。

パラメータ:

  • key_words (str): 検索クエリ文字列
  • num_results (int, オプション): 返される結果の数 (デフォルト: 10)

**戻り値:**記事情報を含む辞書のリスト

検索_medrxiv_advanced

medRxiv の記事の詳細検索を実行します。

パラメータ:

  • term (str, オプション): 一般的な検索用語
  • title (文字列、オプション): タイトル内を検索
  • author1 (文字列、オプション): 最初の著者
  • author2 (文字列、オプション): 2番目の著者
  • abstract_title (文字列、オプション): 概要とタイトルで検索
  • text_abstract_title (文字列、オプション): 全文、要約、タイトルで検索
  • section (str, オプション): medRxivのセクション
  • start_date (str, オプション): 検索範囲の開始日 (形式: YYYY-MM-DD)
  • end_date (str, オプション): 検索範囲の終了日 (形式: YYYY-MM-DD)
  • num_results (int, オプション): 返される結果の数 (デフォルト: 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)

📝 やるべきこと

ダウンロードペーパー

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

論文を読む

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

リスト論文

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

📝 研究のきっかけ

サーバーは、学術論文の分析に役立つ特別なプロンプトを提供します。

論文分析プロンプト

論文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を検索するためのWebスクレイピングロジックが含まれています

🔧 依存関係

  • Python 3.10以上
  • ファストMCP
  • 非同期
  • 伐採
  • リクエスト(Webスクレイピング用、medrxiv_web_search.pyで使用)
  • beautifulsoup4 (Webスクレイピング用、medrxiv_web_search.pyで使用)

必要な依存関係は以下を使用してインストールできます。

pip install FastMCP requests beautifulsoup4

🤝 貢献する

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

📄 ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています。

🙏 謝辞

このプロジェクトは、arxiv-mcp-serverプロジェクトで行われた作業に触発され、その作業に基づいて構築されました。

⚠️免責事項

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

-
security - not tested
F
license - not found
-
quality - not tested

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

medRxiv MCPサーバーは、モデルコンテキストプロトコル(MCP)を介してAIアシスタントとmedRxivのプレプリントリポジトリ間の橋渡しを提供します。これにより、AIモデルは健康科学分野のプレプリントを検索し、アクセスできるようになります。

  1. ✨ Core Features
    1. 🚀 Quick Start
      1. Installing via Smithery
      2. CLine
      3. Installing Manually
    2. 📊 Usage
      1. Example 1: Search for papers using keywords
      2. Example 2: Perform an advanced search
      3. Example 3: Get metadata for a specific paper
    3. 🛠 MCP Tools
      1. search_medrxiv_key_words
      2. search_medrxiv_advanced
      3. get_medrxiv_metadata
    4. Usage with Claude Desktop
      1. Searching Papers
      2. Getting Paper Details
    5. 📝 TODO
      1. download_paper
      2. read_paper
      3. list_papers
      4. 📝 Research Prompts
    6. 📁 Project Structure
      1. 🔧 Dependencies
        1. 🤝 Contributing
          1. 📄 License
            1. 🙏 Acknowledgements
              1. ⚠️ Disclaimer
                ID: ironbbme6d