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 服务器:

克劳德

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 "{}"

克莱恩

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 服务器提供的三个主要工具。请根据您的具体用例调整参数。

🛠 MCP 工具

medRxiv MCP 服务器提供以下工具:

搜索medrxiv关键词

使用关键词在 medRxiv 上搜索文章。

参数:

  • key_words (str):搜索查询字符串
  • num_results (int,可选):返回的结果数(默认值:10)

**返回:**包含文章信息的字典列表

search_medrxiv_advanced

对 medRxiv 上的文章进行高级搜索。

参数:

  • term (str,可选):一般搜索词
  • title (str,可选):在标题中搜索
  • author1 (str,可选):第一作者
  • author2 (str, 可选): 第二作者
  • abstract_title (str,可选):在摘要和标题中搜索
  • text_abstract_title (str,可选):在全文、摘要和标题中搜索
  • section (str,可选):medRxiv 的部分
  • start_date (str,可选):搜索范围的开始日期(格式:YYYY-MM-DD)
  • end_date (str,可选):搜索范围的结束日期(格式:YYYY-MM-DD)
  • num_results (int,可选):返回的结果数(默认值:10)

**返回:**包含文章信息的字典列表

获取medrxiv元数据

使用 DOI 获取 medRxiv 文章的元数据。

参数:

  • doi (str): 文章的DOI

**返回:**包含文章元数据的字典

与 Claude Desktop 一起使用

将此配置添加到您的claude_desktop_config.json

(Mac 操作系统)

{ "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 的网络抓取逻辑

🔧 依赖项

  • Python 3.10+
  • FastMCP
  • 异步
  • 日志记录
  • 请求(用于网络抓取,用于 medrxiv_web_search.py)
  • beautifulsoup4(用于网页抓取,用于 medrxiv_web_search.py)

您可以使用以下方式安装所需的依赖项:

pip install FastMCP requests beautifulsoup4

🤝 贡献

欢迎贡献代码!欢迎提交 Pull 请求。

📄 许可证

该项目已获得 MIT 许可。

🙏 致谢

该项目受到arxiv-mcp-server项目的启发并建立在其工作的基础上。

⚠️ 免责声明

此工具仅供研究之用。请遵守 medRxiv 的服务条款并负责任地使用此工具。

ID: ironbbme6d