home / mcp / arxiv mcp server

ArXiv MCP Server

A Model Context Protocol server for searching and analyzing arXiv papers

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "blazickjp-arxiv-mcp-server": {
      "command": "uv",
      "args": [
        "tool",
        "run",
        "arxiv-mcp-server",
        "--storage-path",
        "/path/to/paper/storage"
      ],
      "env": {
        "ARXIV_STORAGE_PATH": "/path/to/storage"
      }
    }
  }
}

You can connect AI assistants to the ArXiv research repository through a lightweight MCP server that lets you search, download, list, and read arXiv papers locally. This bridge makes it practical to integrate scholarly content into your workflows and prompts with a consistent MCP interface.

How to use

You use the server by running it as an MCP endpoint and then calling its four main tools from your MCP client: search papers, download a paper, list downloaded papers, and read a paper. The server stores papers locally so you can quickly access content and build prompts around the material you’ve saved. To start, configure your MCP client to point to the local server process and then invoke the available tools using your client’s standard tool-calling flow.

How to install

Prerequisites you need before installation include a JavaScript runtime (Node) for client tooling and a Python-friendly environment if you plan to run tests or use Python-based tooling. You will also need the uv runtime for local tool execution via the MCP system.

# Install via Smithery (optional helper) - run this if you use the Smithery workflow
npx -y @smithery/cli install arxiv-mcp-server --client claude

# Manual installation via uv (recommended for discovery and local use)
uv tool install arxiv-mcp-server
```,

Configuration and startup

Configure how the server starts through MCP client settings. The following examples show inline MCP JSON configurations for running the server locally with the uv runtime. Choose the variant that matches your development setup.

{
  "mcpServers": {
    "arxiv_mcp": {
      "command": "uv",
      "args": [
        "tool",
        "run",
        "arxiv-mcp-server",
        "--storage-path", "/path/to/paper/storage"
      ]
    }
  }
}

Development mode

If you are developing against a cloned copy of the server, use the directory variant that points to your local source and keep the same storage path.

{
  "mcpServers": {
    "arxiv_mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "path/to/cloned/arxiv-mcp-server",
        "run",
        "arxiv-mcp-server",
        "--storage-path", "/path/to/paper/storage"
      ]
    }
  }
}

Additional configuration notes

The server uses a local storage path to save downloaded papers for faster access and offline reading. If you want to customize storage, modify the storage path provided in the MCP config. The available environment variable for the storage path is ARXIV_STORAGE_PATH.

Troubleshooting and notes

- Ensure the storage path exists and is writable by the running process. - If you encounter permission issues, adjust directory permissions or run with appropriate user rights. - When updating the server code during development, re-run the uv tool install step or restart the MCP endpoint to pick up changes.

Available tools

search_papers

Query arXiv papers with optional filters such as query text, maximum results, date range, and categories.

download_paper

Download a paper by its arXiv ID to local storage for offline reading.

list_papers

List all papers that have been downloaded and are available locally.

read_paper

Read the content of a downloaded paper, returning text or structured content.

deep-paper-analysis

Prompts-based analysis workflow that uses available tools to produce an executive summary, context, methodology, results evaluation, and future directions.