ArXiv MCP Server connects AI assistants to arXiv's open-access repository of scientific papers, enabling programmatic search and retrieval of academic research. Key capabilities: - Query arXiv papers with filters for publication date ranges and subject categories - Download and access full paper content with local caching for faster subsequent retrieval - List and manage collections of downloaded papers - Integrate research workflows through built-in prompts - Store papers locally to reduce network dependencies and improve access speed

[](https://twitter.com/JoeBlazick) [](https://smithery.ai/server/arxiv-mcp-server) [](https://www.python.org/downloads/) [](https://github.com/blazickjp/arxiv-mcp-server/actions/workflows/tests.yml) [](https://opensource.org/licenses/MIT) [](https://pypi.org/project/arxiv-mcp-server/) [](https://pypi.org/project/arxiv-mcp-server/)

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 Model Context Protocol (MCP). It allows AI models to search for papers and access their content in a programmatic way.

🤝 Contribute • 📝 Report Bug

✨ Core Features

🚀 Quick Start

Installing via Smithery

To install ArXiv Server for Claude Desktop automatically via Smithery:

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

Installing Manually

uv tool install arxiv-mcp-server

For development:

# Clone and set up development environment
git clone https://github.com/blazickjp/arxiv-mcp-server.git
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

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

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

3. List Papers

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

4. Read 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

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

This prompt includes:

⚙️ Configuration

Configure through environment variables:

| Variable | Purpose | Default | |----------|---------|---------| | ARXIV_STORAGE_PATH | Paper storage location | ~/.arxiv-mcp-server/papers |

🧪 Testing

Run the test suite:

python -m pytest

📄 License

Released under the MIT License. See