medRxiv MCP 服务器

🔍 使 AI 助手能够通过简单的 MCP 接口搜索和访问 medRxiv 论文。

medRxiv MCP 服务器通过模型上下文协议 (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

用于开发：

# 克隆并设置开发环境
git clone https://github.com/JackKuo666/medRxiv-MCP-Server.git
cd medRxiv-MCP-Server

# 创建并激活虚拟环境
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 服务器提供以下工具：

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)：第一作者
• author2 (str, optional)：第二作者
• 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 使用如下查询搜索论文：

你能帮我在 medRxiv 上搜索最近关于基因组学的论文吗？

搜索将返回有关匹配论文的基本信息，包括：

• 论文标题

• 作者

• DOI

获取论文详细信息

获得 DOI 后，您可以要求提供更多详细信息：

你能给我展示论文 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 的服务条款并负责任地使用此工具。