使用说明

项目简介

medRxiv论文检索MCP服务器是一个基于Model Context Protocol (MCP) 实现的后端服务，旨在帮助AI助手（如Claude、Cursor等）便捷地检索和获取医学预印本平台medRxiv上的学术论文信息。通过标准化的MCP接口，AI助手可以调用服务器提供的工具，实现关键词检索、高级检索以及论文元数据查询等功能，从而更好地服务于科研和信息分析场景。

主要功能点

关键词检索论文: 允许AI助手通过关键词快速检索medRxiv平台上的相关论文。
高级检索论文: 支持更精细化的检索条件，如作者、标题、日期范围等，帮助AI助手更准确地定位目标论文。
获取论文元数据: 根据论文DOI，AI助手可以获取包括标题、作者、摘要、发布日期等详细元数据信息。
易于集成: 遵循MCP协议标准，可以方便地集成到各种支持MCP协议的AI客户端，如Claude Desktop, Cursor, Windsurf, Cline等。

安装步骤

方法一：使用 Smithery (推荐 Claude Desktop 用户)

Smithery 提供了一键安装和管理MCP服务器的便捷方式，推荐 Claude Desktop 用户使用。

安装 Smithery CLI (如果尚未安装): 打开终端，运行以下命令：

npm install -g @smithery/cli

通过 Smithery 安装 medRxiv MCP Server: 根据你使用的客户端，运行相应的命令：

Claude Desktop:

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

Cursor:

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

方法二：手动安装 (适用于开发者和希望自定义配置的用户)

克隆仓库:

git clone https://github.com/JackKuo666/medRxiv-MCP-Server.git
cd medRxiv-MCP-Server

创建并激活虚拟环境 (推荐):

python -m venv .venv  # 或者使用 uv venv
source .venv/bin/activate  # Linux/macOS
.venv\Scripts\activate  # Windows

安装依赖:

pip install -r requirements.txt  # 或者使用 uv pip install -r requirements.txt

服务器配置

重要: 以下配置信息用于配置 MCP客户端 (如 Claude Desktop, Cursor, Cline 等) 连接到 medRxiv MCP 服务器。你 不需要 修改服务器端的任何配置文件。你只需要将以下配置添加到你的 MCP 客户端的配置文件中。

Claude Desktop 配置示例 (Mac OS):

打开 Claude Desktop 的配置文件 'claude_desktop_config.json' (通常位于 '~/Library/Application Support/Anthropic/Claude/config/claude_desktop_config.json')，添加以下 'mcpServers' 配置：

{
  "mcpServers": {
    "medrxiv": {  // 服务器名称，可以自定义
      "command": "python", // 启动服务器的命令
      "args": ["medrxiv_server.py"] // 启动服务器命令的参数，指向服务器主程序
      }
  }
}

Claude Desktop 配置示例 (Windows):

{
  "mcpServers": {
    "medrxiv": {  // 服务器名称，可以自定义
      "command": "C:\\Users\\YOUR_USERNAME\\AppData\\Local\\Programs\\Python\\Python311\\python.exe", //  请替换为你的Python解释器路径
      "args": [
        "medrxiv_server.py" // 启动服务器命令的参数，指向服务器主程序
      ]
    }
  }
}

Cline 配置示例:

{
  "mcpServers": {
    "medrxiv": {
      "command": "bash",
      "args": [
        "-c",
        "source /home/YOUR/PATH/medRxiv-MCP-Server/.venv/bin/activate && python /home/YOUR/PATH/medRxiv-MCP-Server/medrxiv_server.py" // 请替换为你的项目路径
      ],
      "env": {},
      "disabled": false,
      "autoApprove": []
    }
  }
}

注意:

请根据你的Python安装路径和项目实际路径，修改 'command' 和 'args' 中的内容。
'server name' (例如 "medrxiv") 可以自定义，用于在客户端中标识该服务器。

基本使用方法

启动 MCP 服务器: 如果你是手动安装的，在项目根目录下，激活虚拟环境后，运行以下命令启动服务器：
```
python medrxiv_server.py
```
如果你使用 Smithery 安装，服务器通常会自动启动。

在 AI 客户端中使用: 配置完成后，重启你的 MCP 客户端 (如 Claude Desktop)。现在你可以通过自然语言指令，指示 AI 助手使用 medRxiv 服务器的功能。

示例指令:

关键词检索:

请在 medRxiv 上搜索关于 COVID-19 疫苗有效性的最新论文。

获取论文详情:

请展示 DOI 为 10.1101/2025.03.09.25323517 的论文的详细信息。

AI助手会将这些指令转换为对 medRxiv MCP 服务器的工具调用，并返回检索结果或论文元数据。