This MCP server exposes an arXiv integration that lets AI assistants search, retrieve details, and construct complex queries against arXiv's repository. Available functions include search_papers for flexible keyword and metadata queries, get_paper_details to fetch complete metadata for a specific arXiv ID, build_advanced_query to compose multi-field searches, and get_arxiv_categories to list arXiv subject areas. There are also helper functions like search_by_author and search_by_category (with noted limitations). You can retrieve results and then drill into papers for metadata, abstracts, and links to PDFs from the arXiv results. Start the server with uv run main.py and use the provided function calls to interact with arXiv data within your AI workflow.

Prerequisites:

• Python 3.12+
• uv package manager (install via pipx or your preferred method)
• Optional: Docker if you prefer containerized deployment

Installation steps (local development):

1. Clone the repository: git clone https://github.com/tejas242/arxiv-mcp.git cd arxiv-mcp

2. Install and set up uv in your environment if not already installed. For example, using pipx: pipx install uv

   or ensure uv is available in your Python environment

3. Sync dependencies (if applicable): uv sync

4. Run the MCP server locally: uv run main.py

Docker installation (recommended for production):

1. Pull and run the Docker image: docker run --rm -it ghcr.io/tejas242/arxiv-mcp:latest

2. Or use docker-compose if provided in the repository: git clone https://github.com/tejas242/arxiv-mcp.git cd arxiv-mcp docker compose up

Notes and tips:

• This MCP server relies on the uv package manager to run the Python-based server. If you encounter environment issues, ensure Python 3.12+ is installed and that uv can access your project directory.
• The available functions are listed in the README; core search is the primary workflow using search_papers, while get_paper_details provides full metadata for a chosen arXiv ID.
• The download_paper_pdf function exists but is marked as needing fixes due to redirect handling; direct PDF links from search results may be used as a workaround.
• If you use Claude Desktop or VS Code MCP configurations, you can embed the server settings under mcpServers or mcp, respectively, referencing the uv command with the appropriate directory and entry point (main.py).
• The README mentions Docker image availability; using the Docker option isolates dependencies and simplifies deployment.