prashalruchiranga/arxiv-mcp-server

A Model Context Protocol (MCP) server that enables interacting with the arXiv API using natural language.
Features
- Retrieve metadata about scholarly articles hosted on arXiv.org
- Download articles in PDF format to the local machine
- Search arXiv database for a particular query
- Retrieve articles and load them into a large language model (LLM) context
Tools
- **get_article_url**
- Retrieve the URL of an article hosted on arXiv.org based on its title
- title (String): Article title
- **download_article**
- Download the article hosted on arXiv.org as a PDF file
- title (String): Article title
- **load_article_to_context**
- Load the article hosted on arXiv.org into context of a LLM
- title (String): Article title
- **get_details**
- Retrieve metadata of an article hosted on arXiv.org based on its title
- title (String): Article title
- **search_arxiv**
- Performs a search query on the arXiv API based on specified parameters and returns matching article metadata
- all_fields (String): General keyword search across all metadata fields
- title (String): Keyword(s) to search for within the titles of articles
- author (String): Author name(s) to filter results by
- abstract (String): Keyword(s) to search for within article abstracts
- start (int): Index of the first result to return
Setup
MacOS
Clone the repository
Install uv package manager. For more details on installing, visit the official uv documentation.
Create and activate virtual environment.
Install development dependencies.
Windows
Install uv package manager. For more details on installing, visit the official uv documentation.
Close and reopen the shell, then clone the repository.
Create and activate virtual environment.
Install development dependencies.
Usage with Claude Desktop
To enable this integration, add the server configuration to your claude_desktop_config.json file. Make sure to create the file if it doesn’t exist.
On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json On Windows: %APPDATA%/Roaming/Claude/claude_desktop_config.json