home / mcp / arxiv mcp server

arXiv MCP Server

Provides a Model Context Protocol server to search, download, read, and manage arXiv papers.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "freyzo-mcp-arxiv": {
      "command": "/path/to/.venv/bin/python",
      "args": [
        "-m",
        "arxiv_mcp_server",
        "--storage-path",
        "/path/to/papers"
      ],
      "env": {
        "PYTHONPATH": "/path/to/arxiv-mcp-server/src",
        "ARXIV_STORAGE_PATH": "/home/user/.arxiv-mcp-server/papers"
      }
    }
  }
}

You can run an arXiv Model Context Protocol (MCP) server locally to search, download, read, and manage arXiv papers. This server provides a focused workflow for discovering papers, converting PDFs to readable Markdown, and performing in-depth analyses through prompts and built-in tools.

How to use

You will connect an MCP client to the arXiv MCP server to perform common tasks. Start by starting the MCP server in your environment, then use your MCP client to issue commands that search for papers, download PDFs and convert them to Markdown, read stored content, or list all downloaded papers. When you invoke a deep-analysis prompt, the system will generate a comprehensive executive summary, describe methodology, summarize results, and outline potential implications and future directions.

How to install

Prerequisites: Python 3.11 or newer.

Install the MCP server locally by cloning the project, setting up a virtual environment, and installing the package in editable mode.

git clone <repo-url>
cd arxiv-mcp-server
python3 -m venv .venv
source .venv/bin/activate
pip install -e .

Available tools

search_papers

Query arXiv with filters such as date, category, and sort order to locate relevant papers.

download_paper

Fetch the paper PDF and convert it to Markdown for easy reading and storage.

list_papers

Display all papers that have been downloaded and stored locally.

read_paper

Open and read the content of a stored paper by its identifier.

deep-paper-analysis

Perform an in-depth analysis workflow on a paper, including executive summary, methodology, results, implications, and future directions.