🚀 medRxiv 中文 MCP 服务器文档

本项目是一个用于与 medRxiv 学术平台交互的 MCP（Multi-Protocol Client）服务器实现。借助该服务器，用户能够通过多种协议开展学术论文的搜索、下载和分析工作。

🚀 快速开始

本服务器允许用户通过多种协议进行学术论文的搜索、下载和分析。在使用前，请确保完成安装步骤。

📦 安装指南

安装 Python 环境

建议使用 Python 3.10+ 版本。

安装依赖项

运行以下命令安装所需库：

pip install FastMCP requests beautifulsoup4

💻 使用示例

启动服务器

运行主脚本即可启动 MCP 服务器：

python medrxiv_server.py

搜索论文

可以通过以下协议进行论文搜索：

🔍 HTTP 协议示例

使用 curl 命令进行搜索：

curl -X POST http://localhost:5000/api/search \
     -H "Content-Type: application/json" \
     -d '{"query": "recent papers on genomics"}'

🔌 WebSocket 协议示例

使用 WebSocket 客户端连接服务器：

const ws = new WebSocket('ws://localhost:5001');
await ws.send(JSON.stringify({ query: "最近关于基因组学的论文" }));

获取论文详情

通过 DOI 查询论文详情：

🔍 HTTP 协议示例

curl http://localhost:5000/api/paper/10.1101/003541

🔌 WebSocket 协议示例

const ws = new WebSocket('ws://localhost:5001');
await ws.send(JSON.stringify({ doi: "10.1101/003541" }));

📚 详细文档

待办事项

下载论文

实现一个功能以下载并保存论文到本地。

阅读论文内容

实现对已下载论文内容的阅读功能。

列出所有下载论文

列出用户所有已下载的论文列表。

研究分析提示

提供一组针对学术论文分析的专用提示：

论文分析提示示例

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

该提示包括：

• 使用现有工具（list_papers, download_paper, read_paper, search_papers）的详细说明。
• 系统化的分析流程。
• 详细的分析结构，涵盖：
  • 执行摘要
  • 研究背景
  • 方法论分析
  • 结果评估
  • 实际和理论影响
  • 未来研究方向
  • 更广泛的影响

项目结构

• medrxiv_server.py：MCP 服务器的主要实现文件，使用 FastMCP 框架。
• search.py：论文搜索功能的实现模块。
• download.py：论文下载功能的实现模块。
• analysis.py：论文分析功能的实现模块。

依赖项

• FastMCP：用于构建高效的 MCP 服务器框架。
• requests：用于 HTTP 请求的发送和处理。
• beautifulsoup4：用于网页内容的解析和提取。

贡献指南

提交代码

使用以下命令提交代码：

git add . && git commit -m "你的提交信息" && git push origin main

开发流程

遵循标准的 Git 工作流进行开发，确保代码质量。

📄 许可证

本项目采用 MIT License 许可证。更多信息请参考： MIT 许可证

⚠️ 免责声明

使用本工具时，请遵守相关法律法规和 medRxiv 的服务条款，确保负责任地使用此工具。

注意：本项目为示例性质的开源项目，具体实现细节可能与实际产品有所差异。使用前请仔细阅读相关文档并测试。