微信扫一扫article
README
🚀 ArXiv Paper MCP
ArXiv Paper MCP 是一个基于 arXiv 的论文检索与内容解析工具。它支持 Model Context Protocol (MCP) 标准，可提供论文搜索、PDF 链接获取和内容解析等功能，为学术研究提供便利。
🚀 快速开始
ArXiv Paper MCP 是一款强大的工具，能帮助你高效检索和解析 arXiv 论文。你可以通过以下推荐的 NPX 方式快速使用，也能选择全局安装。
NPX 方式（推荐）
npx @langgpt/arxiv-paper-mcp
全局安装
npm install -g @langgpt/arxiv-paper-mcp
arxiv-paper-mcp
✨ 主要特性
- 🔍 arXiv 论文智能搜索：支持关键词检索，能让你快速定位关心的论文。
- 🔗 获取 PDF 下载链接：可直接获取 arXiv 论文的 PDF 下载链接。
- 📄 论文内容解析：智能解析论文内容，优先使用 HTML 版本，若不可用则回退到 PDF。
- 🆕 AI 领域最新论文：能获取 arXiv AI 领域今日最新更新的论文列表。
📦 安装指南
NPX 方式（推荐）
npx @langgpt/arxiv-paper-mcp
全局安装
npm install -g @langgpt/arxiv-paper-mcp
arxiv-paper-mcp
💻 使用示例
基础用法
以下是使用该工具的基本流程示例：
- 搜索论文：使用
search_arxiv工具搜索相关论文。 - 获取最新 AI 论文：用
get_recent_ai_papers工具获取今日最新 AI 领域论文。 - 获取 PDF 链接：用
get_arxiv_pdf_url工具获取 PDF 下载链接。 - 解析论文内容：用
parse_paper_content工具获取论文的文本内容（优先 HTML，回退 PDF）。
高级用法
你可以根据不同的需求，灵活组合使用工具和参数，以满足多样化的论文检索和解析需求。
📚 详细文档
MCP 客户端配置
Claude Desktop 配置
在 Claude Desktop 的配置文件中添加如下内容：
{
"mcpServers": {
"arxiv-paper-mcp": {
"command": "npx",
"args": ["-y", "@langgpt/arxiv-paper-mcp@latest"]
}
}
}
配置文件位置：
- macOS：
~/Library/Application Support/Claude/claude_desktop_config.json - Windows：
%APPDATA%\Claude\claude_desktop_config.json
其他 MCP 客户端
对于其他支持 MCP 的客户端，请参考其文档配置 stdio 传输方式。
可用工具与参数
1. 搜索论文
- 工具名：
search_arxiv - 参数：
query：搜索关键词maxResults：返回论文数（可选，默认 5）
2. 获取 PDF 下载链接
- 工具名：
get_arxiv_pdf_url - 参数：
input：arXiv 论文 URL 或 arXiv ID（如：2403.15137v1）
3. 解析论文内容
- 工具名：
parse_paper_content - 参数：
input：arXiv 论文 URL 或 arXiv IDpaperInfo：论文元信息（可选，用于添加论文元数据）
4. 获取 AI 领域最新论文
- 工具名：
get_recent_ai_papers - 参数：无
🔧 技术细节
开发指南
本地开发
# 克隆项目
git clone https://github.com/yzfly/arxiv-paper-mcp.git
cd arxiv-paper-mcp
# 安装依赖
npm install
# 开发模式运行
npm run dev
# 构建
npm run build
# 运行构建版本
npm start
项目结构
arxiv-paper-mcp/
├── src/
│ └── index.ts # 主服务器文件
├── build/ # 编译输出目录
├── package.json # 项目配置
├── tsconfig.json # TypeScript 配置
├── README.md # 项目说明
└── LICENSE # 许可证
技术栈
- Node.js >= 18.0.0
- TypeScript - 类型安全的 JavaScript
- Model Context Protocol - 标准化的 AI 上下文协议
- arXiv API - 学术论文数据源
故障排除
常见问题
- 论文搜索失败
错误：搜索失败
解决：检查网络连接，确保搜索关键词正确
- PDF 解析失败
错误：PDF 解析失败
解决：检查 arXiv ID 是否正确，确保论文存在
日志调试
启用详细日志：
DEBUG=arxiv-paper-mcp npx @langgpt/arxiv-paper-mcp
📄 许可证
本项目采用 MIT 许可证。详情请见 LICENSE 文件。
👨💻 作者信息
- 作者：yzfly
- 邮箱：yz.liu.me@gmail.com
- GitHub：https://github.com/yzfly
🔗 相关链接
🎉 支持
如果您觉得这个项目有用，请给它一个 ⭐！
如有问题或建议，请通过以下方式联系：