mcp-registry/arxiv-mcp-server

    ==================
      
       /// MCP ///
      /// ARX ///
        
    ==================
        
    [server:online]
    [protocol:ready]

arxiv-mcp-server

by blazickjp

Model-Context-Protocol (MCP) server that lets AI assistants search, download and analyse arXiv papers through a simple tool interface.

1.5k
93
Open Source
GitHubDocumentation

01

search_papers

Search arXiv for papers using a query with optional filters like max_results, date range, and categories

02

download_paper

Download a specific paper from arXiv by its arXiv ID and save it locally

03

list_papers

List all papers that have already been downloaded to local storage

04

read_paper

Read or retrieve the full content of a previously downloaded paper by its arXiv ID

Installation

1. Prerequisites
• Python ≥3.9
• git
2. Clone the repository
git clone https://github.com/blazickjp/arxiv-mcp-server.git cd arxiv-mcp-server
3. Create and activate a virtual environment (recommended)
python -m venv .venv source .venv/bin/activate # Windows: .venv\Scripts\activate
4. Install the package and its dependencies
pip install -U pip pip install -r requirements.txt # or: pip install .
5. Required environment variables
export OPENAI_API_KEY="<your-openai-key>" # Only if LLM summaries are enabled export ARXIV_MCP_PORT=8000 # Port FastAPI server will bind (optional)
6. Run database migrations (if provided)
python scripts/init_db.py # Skip if not present
7. Start the MCP server
uvicorn arxiv_mcp_server.main:app --host 0.0.0.0 --port ${ARXIV_MCP_PORT:-8000}
8. Verify
curl http://localhost:8000/health # should return {"status": "ok"}
9. (Optional) Docker
docker build -t arxiv-mcp-server . docker run -e OPENAI_API_KEY -p 8000:8000 arxiv-mcp-server
10. Reverse-proxy behind nginx / Caddy if deploying to production.

Documentation

License: Apache License 2.0
Updated 7/30/2025