ArXiv-MCP
About
Search and retrieve academic papers from arXiv based on keywords.
Details
- Author
- kelvingao
- Categories
- Search, Other
Jump to
Setup
Install ArXiv-MCP in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/kelvingao/arxiv-mcp
Follow the installation instructions in the repository README, then restart your MCP client.
ArXiv-MCP: Academic Paper Search for AI Agents
AModel Context Protocol (MCP)server implementation that enables AI agents to search, retrieve, and analyze academic papers fromarXiv, the popular open-access repository of electronic preprints.
This project provides an MCP server that allows AI agents to interact with the arXiv repository, search for papers based on keywords, retrieve detailed information about specific papers, and even extract and analyze the content of papers. It serves as both a practical tool for research assistance and a reference implementation for building MCP servers.
The implementation follows the best practices laid out for building MCP servers, allowing seamless integration with any MCP-compatible client.
The server provides several powerful tools for academic research:
- search_papers: Search for papers on arXiv using keywords and get comprehensive summaries
- get_paper_details: Retrieve detailed information about a specific paper by its arXiv ID
- extract_paper_content: Download and extract the full text content from a paper's PDF
- analyze_paper: Analyze a paper's content and generate a comprehensive summary
- Python 3.11+
- Docker if running the MCP server as a container (recommended)
git clone https://github.com/kelvingao/arxiv-mcp.git cd arxiv-mcp
Create a.envfile based on.env.example:
Configure your environment variables in the.envfile (see Configuration section)
docker build -t mcp/arxiv --build-arg PORT=8050 .
Create a.envfile based on.env.exampleand configure your environment variables
The following environment variables can be configured in your.envfile:
# Set TRANSPORT=sse in .env then: python src/server.py
The MCP server will run as an API endpoint that you can connect to with the configuration shown below.
With stdio, the MCP client itself can spin up the MCP server, so nothing to run at this point.
docker run --env-file .env -p 8050:8050 mcp/arxiv
The MCP server will run as an API endpoint within the container that you can connect to with the configuration shown below.
With stdio, the MCP client itself can spin up the MCP server container, so nothing to run at this point.
Once you have the server running with SSE transport, you can connect to it using this configuration:
{ "mcpServers": { "arxiv": { "transport": "sse", "url": "http://localhost:8050/sse" } } }
Note for Windsurf users: UseserverUrlinstead ofurlin your configuration:
{ "mcpServers": { "arxiv": { "transport": "sse", "serverUrl": "http://localhost:8050/sse" } } }
Note for n8n users: Use host.docker.internal instead of localhost since n8n has to reach outside of its own container to the host machine:
So the full URL in the MCP node would be:http://host.docker.internal:8050/sse
Make sure to update the port if you are using a value other than the default 8050.
Add this server to your MCP configuration for Claude Desktop, Windsurf, or any other MCP client:
{ "mcpServers": { "arxiv": { "command": "your/path/to/arxiv-mcp/.venv/bin/python", "args": ["your/path/to/arxiv-mcp/src/main.py"], "env": { "TRANSPORT": "stdio" } } } }
{ "mcpServers": { "arxiv": { "command": "docker", "args": ["run", "--rm", "-i", "-e", "TRANSPORT", "mcp/arxiv"], "env": { "TRANSPORT": "stdio" } } } }
Here are some examples of how to use the arXiv MCP server with an AI agent:
Find recent papers about quantum computing published in the last year.
Get details for the paper with arXiv ID 2303.08774
Extract the full text from the paper with arXiv ID 2303.08774
Analyze the methodology section of the paper with arXiv ID 2303.08774
This implementation provides a foundation for building more complex MCP servers. To build your own:
- Add your own tools by creating methods with the@mcp.tool()decorator
- Create your own lifespan function to add your own dependencies (clients, database connections, etc.)
- Modify the existing tools or add new ones to enhance functionality
- Add prompts and resources with@mcp.resource()and@mcp.prompt()
- arXivfor providing open access to research papers
- TheModel Context Protocolteam for creating the MCP standard
Search global news using natural language. Webz.io News Search API returns the most relevant articles and content, with filters for source, country, language, date, sentiment, and category.
A flexible service for searching and analyzing academic papers on arXiv.
A server for searching academic papers and preprints on arXiv.org.
Search and access academic paper metadata from Crossref.
Search and cite exact passages across complete classical and world-literature corpora.
Search and retrieve cryptographic research papers from the IACR Cryptology ePrint Archive.
Anonymous, read-only, source-backed Buddhist scripture search, passage guidance, explanation, and one-time practice planning through four production MCP tools.
Search and retrieve articles from medRxiv, the preprint server for health sciences.
Search and access academic papers from Sci-Hub by DOI, title, or keyword.
Search and retrieve academic papers from the arXiv repository via its API.
Search and retrieve technical documentation for T&M, industrial automation, and power electronics. Covers everything from oscilloscopes, microcontrollers, vehicles, power supplies, and more from a wide range of manufacturers.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
