Arxiv MCP Server

17 forks

146 stars

Free

What is arxiv-mcp-server

The arxiv-mcp-server is a tool created by blazickjp designed to facilitate AI-driven research by providing seamless access to arXiv's vast collection of research papers. This server acts as a bridge between AI assistants and the arXiv repository, utilizing the Model Context Protocol (MCP) to enable efficient searches and retrievals of academic papers. It supports AI systems in enhancing their research capabilities by allowing them to programmatically search, download, and analyze research papers.

How to Use arxiv-mcp-server

To get started with the arxiv-mcp-server, you can install it using either the Smithery CLI or manually through the 'uv' tool. For automatic installation, execute the following command in your terminal:

npx -y @smithery/cli install arxiv-mcp-server --client claude

For manual installation, use:

uv tool install arxiv-mcp-server

In a development setup, clone the repository, set up a virtual environment, and install with test dependencies. The server is integrated with your MCP client by configuring the client config file to include the arxiv-mcp-server with the appropriate commands and storage path settings. This setup ensures that your AI assistant can leverage the server's full functionality for accessing and analyzing academic papers.

Key Features of arxiv-mcp-server

The arxiv-mcp-server is equipped with several robust features to enhance research workflows:

Paper Search: Enables querying of arXiv papers with filters for specific date ranges and categories, helping users find relevant research efficiently.
Paper Access: Facilitates the downloading and reading of paper content, making it easy for AI systems to retrieve and utilize research data.
Paper Listing: Allows users to view all downloaded papers, providing an organized approach to managing research materials.
Local Storage: Stores papers locally, ensuring faster access and retrieval of previously downloaded content.
Research Prompts: Offers a set of specialized prompts designed to assist in the detailed analysis of academic papers. This includes comprehensive workflows and structured analysis methodologies.

The server also supports a range of tools for specific tasks:

Paper Search: Search and filter papers based on queries and categories.
Paper Download: Retrieve papers using their arXiv IDs.
List Papers: Display all papers that have been downloaded.
Read Paper: Access the content of a downloaded paper for analysis.

These features collectively enable AI models to engage deeply with academic research, providing insights and facilitating the efficient processing of large volumes of scholarly data. With the arxiv-mcp-server, AI assistants are empowered to conduct thorough research, analyze methodologies, and derive meaningful conclusions from academic literature.

Twitter Follow Python Version License: MIT PyPI Downloads PyPI Version

ArXiv MCP Server

🔍 Enable AI assistants to search and access arXiv papers through a simple MCP interface. The ArXiv MCP Server provides a bridge between AI assistants and arXiv's research repository through the Message Control Protocol (MCP). It allows AI models to search for papers and access their content in a programmatic way. 🤝 Contribute • 📝 Report Bug

✨ Core Features

🔎 Paper Search: Query arXiv papers with filters for date ranges and categories
📄 Paper Access: Download and read paper content
📋 Paper Listing: View all downloaded papers
🗃️ Local Storage: Papers are saved locally for faster access
📝 Prompts: A Set of Research Prompts

🚀 Quick Start

Installing via

To install ArXiv Server for Claude Desktop automatically via :

npx -y @/cli install arxiv-mcp-server --client claude

Installing Manually

Install using uv:

uv tool install arxiv-mcp-server

For development:

# Clone and set up development environment
git clone 
cd arxiv-mcp-server
# Create and activate virtual environment
uv venv
source .venv/bin/activate
# Install with test dependencies
uv pip install -e ".[test]"

🔌 MCP Integration

Add this configuration to your MCP client config file:

 "mcpServers": {
 "arxiv-mcp-server": {
 "command": "uv",
 "args": [
 "tool",
 "run",
 "arxiv-mcp-server",
 "--storage-path", "/path/to/paper/storage"

For Development:

 "mcpServers": {
 "arxiv-mcp-server": {
 "command": "uv",
 "args": [
 "--directory",
 "path/to/cloned/arxiv-mcp-server",
 "run",
 "arxiv-mcp-server",
 "--storage-path", "/path/to/paper/storage"

💡 Available Tools

The server provides four main tools:

1. Paper Search

Search for papers with optional filters:

result = await call_tool("search_papers", {
 "query": "transformer architecture",
 "max_results": 10,
 "date_from": "2023-01-01",
 "categories": ["cs.AI", "cs.LG"]

2. Paper Download

Download a paper by its arXiv ID:

result = await call_tool("download_paper", {
 "paper_id": "2401.12345"

3. List Papers

View all downloaded papers:

result = await call_tool("list_papers", {})

4. Read Paper

Access the content of a downloaded paper:

result = await call_tool("read_paper", {
 "paper_id": "2401.12345"

📝 Research Prompts

The server offers specialized prompts to help analyze academic papers:

Paper Analysis Prompt

A comprehensive workflow for analyzing academic papers that only requires a paper ID:

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

This prompt includes:

Detailed instructions for using available tools (list_papers, download_paper, read_paper, search_papers)
A systematic workflow for paper analysis
Comprehensive analysis structure covering:
Executive summary
Research context
Methodology analysis
Results evaluation
Practical and theoretical implications
Future research directions
Broader impacts

⚙️ Configuration

🧪 Testing

Run the test suite:

python -m pytest

📄 License

Released under the MIT License. See the LICENSE file for details. Made with ❤️ by the Pearl Labs Team

How to Use

To use the arxiv-mcp-server, follow these steps:

Visit https://github.com/blazickjp/arxiv-mcp-serverhttps://github.com/blazic...
Follow the setup instructions to create an account (if required)
Connect the MCP server to your Claude Desktop application
Start using arxiv-mcp-server capabilities within your Claude conversations

Additional Information

Created

March 12, 2025

Company

blazickjp

Related MCP Servers

Start building your own MCP Server

Interested in creating your own MCP Server? Check out the official documentation and resources.

Learn More