一个基于 arXiv 的论文检索与内容解析工具,支持 Model Context Protocol (MCP) 标准。提供论文搜索、PDF链接获取和内容解析功能。
6.4k 查看 · 2026-07-07 更新
简介
一个基于 arXiv 的论文检索与内容解析工具,支持 Model Context Protocol (MCP) 标准。提供论文搜索、PDF链接获取和内容解析功能。
简介
一个基于 arXiv 的论文检索与内容解析工具,支持 Model Context Protocol (MCP) 标准。提供论文搜索、PDF链接获取和内容解析功能。
ArXiv Paper MCP
A paper search and content parsing tool based on arXiv. Supports the Model Context Protocol (MCP) standard, providing functions for paper search, PDF link acquisition, and content parsing.
Features
- 🔍 Intelligent arXiv Paper Search: Keyword-based search to quickly locate the papers you care about
- 🔗 Get PDF Download Links: Obtain direct PDF download links for arXiv papers
- 📄 Paper Content Parsing: Smartly parse paper content, with preference given to HTML versions, falling back to PDF
- 🆕 Latest AI Papers: Get a list of the latest updated AI papers on arXiv today
Installation and Usage
NPX Method (Recommended)
bash npx @langgpt/arxiv-paper-mcp
Global Installation
bash npm install -g @langgpt/arxiv-paper-mcp arxiv-paper-mcp
MCP Client Configuration
Claude Desktop Configuration
Add the following to the Claude Desktop configuration file:
json { "mcpServers": { "arxiv-paper-mcp": { "command": "npx", "args": ["-y", "@langgpt/arxiv-paper-mcp@latest"] } } }
Configuration file locations:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
Other MCP Clients
For other MCP-supported clients, please refer to their documentation for configuring stdio transport.
Available Tools and Parameters
1. Search Papers
- Tool Name:
search_arxiv - Parameters:
query: Search keywordsmaxResults: Number of papers to return (optional, default 5)
2. Get PDF Download Link
- Tool Name:
get_arxiv_pdf_url - Parameters:
input: arXiv paper URL or arXiv ID (e.g., 2403.15137v1)
3. Parse Paper Content
- Tool Name:
parse_paper_content - Parameters:
input: arXiv paper URL or arXiv IDpaperInfo: Metadata of the paper (optional, used to add metadata to the paper)
4. Get Recent AI Papers
- Tool Name:
get_recent_ai_papers - Parameters: None
Example Usage Workflow
- Search Papers
Use the
search_arxivtool to find relevant papers. - Get Latest AI Papers
Use the
get_recent_ai_paperstool to get today's latest AI papers. - Get PDF Link
Use the
get_arxiv_pdf_urltool to obtain the PDF download link. - Parse Paper Content
Use the
parse_paper_contenttool to get the text content of the paper (preferring HTML, falling back to PDF).
Development Guide
Local Development
bash
Clone the project
git clone https://github.com/yzfly/arxiv-paper-mcp.git cd arxiv-paper-mcp
Install dependencies
npm install
Run in development mode
npm run dev
Build
npm run build
Run the built version
npm start
Project Structure
arxiv-paper-mcp/ ├── src/ │ └── index.ts # Main server file ├── build/ # Compilation output directory ├── package.json # Project configuration ├── tsconfig.json # TypeScript configuration ├── README.md # Project description └── LICENSE # License
Tech Stack
- Node.js >= 18.0.0
- TypeScript - Type-safe JavaScript
- Model Context Protocol - Standardized AI context protocol
- arXiv API - Academic paper data source
Troubleshooting
Common Issues
-
Paper Search Failure
Error: Search failed Solution: Check your internet connection and ensure the search keywords are correct
-
PDF Parsing Failure
Error: PDF parsing failed Solution: Check if the arXiv ID is correct and ensure the paper exists
Debugging Logs
Enable detailed logs: bash DEBUG=arxiv-paper-mcp npx @langgpt/arxiv-paper-mcp
Contribution Guidelines
Contributions are welcome! Please follow these steps:
- Fork this repository
- Create a feature branch:
git checkout -b feature/amazing-feature - Commit your changes:
git commit -m 'Add amazing feature' - Push the branch:
git push origin feature/amazing-feature - Create a Pull Request
License
This project is licensed under the MIT License. See the LICENSE file for details.
Author Information
- Author: yzfly
- Email: yz.liu.me@gmail.com
- GitHub: https://github.com/yzfly
Related Links- Model Context Protocol
Support
If you find this project useful, please give it a ⭐!
For any questions or suggestions, feel free to reach out via:
- 📧 Email: yz.liu.me@gmail.com
- 🐛 GitHub Issues: Project Issue Tracker
- 💬 GitHub Discussions: Project Discussion Forum
工具列表
-
search_arxiv: 搜索 arXiv 论文
-
get_recent_ai_papers: 获取 arXiv AI 领域最新论文(cs.AI/recent)
-
get_arxiv_pdf_url: 获取 arXiv PDF 下载链接
-
parse_paper_content: 解析论文内容(优先使用 HTML 版本,回退到 PDF)
服务配置
[{'mcpServers': {'arxiv-paper-mcp': {'args': ['-y', '@langgpt/arxiv-paper-mcp@latest'], 'command': 'npx'}}}]
来源
- 来源:github
- 链接:https://github.com/yzfly/Arxiv-Paper-MCP