ArXiv Paper MCP

一个基于 arXiv 的论文检索与内容解析工具支持 Model Context Protocol (MCP) 标准提供论文搜索PDF链接获取和内容解析功能

基于原项目: 此项目基于 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

MCP 客户端配置

Claude Desktop 配置

在 Claude Desktop 的配置文件中添加

{
  "mcpServers": {
    "arxiv-paper-mcp": {
      "command": "npx",
      "args": ["-y", "bach-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
• 参数:
  • inputarXiv 论文 URL 或 arXiv ID如2403.15137v1

3. 解析论文内容

• 工具名: parse_paper_content
• 参数:
  • inputarXiv 论文 URL 或 arXiv ID
  • paperInfo论文元信息可选用于添加论文元数据

4. 获取AI领域最新论文

• 工具名: get_recent_ai_papers
• 参数: 无

使用流程示例

1. 搜索论文
   使用 search_arxiv 工具搜索相关论文
2. 获取最新AI论文
   用 get_recent_ai_papers 工具获取今日最新AI领域论文
3. 获取PDF链接
   用 get_arxiv_pdf_url 工具获取PDF下载链接
4. 解析论文内容
   用 parse_paper_content 工具获取论文的文本内容优先 HTML回退 PDF

开发指南

本地开发

# 克隆项目
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 - 学术论文数据源

故障排除

常见问题

1. 论文搜索失败

   错误搜索失败
   解决检查网络连接确保搜索关键词正确
   

2. PDF解析失败

   错误PDF 解析失败
   解决检查 arXiv ID 是否正确确保论文存在
   

日志调试

启用详细日志

DEBUG=arxiv-paper-mcp npx @langgpt/arxiv-paper-mcp

贡献指南

欢迎贡献代码请遵循以下步骤

1. Fork 本项目
2. 创建特性分支git checkout -b feature/amazing-feature
3. 提交更改git commit -m 'Add amazing feature'
4. 推送分支git push origin feature/amazing-feature
5. 创建 Pull Request

许可证

本项目采用 MIT 许可证详情请见 LICENSE 文件

作者信息

• 作者: yzfly
• 邮箱: yz.liu.me@gmail.com
• GitHub: https://github.com/yzfly

相关链接

• Model Context Protocol
• arXiv.org
• Claude Desktop

支持

如果您觉得这个项目有用请给它一个

如有问题或建议请通过以下方式联系

• 邮箱yz.liu.me@gmail.com
• GitHub Issues项目问题追踪
• GitHub Discussions项目讨论区