arxiv

The ArXiv MCP Server exposes four core tools that allow AI assistants to search, download, list, and read arXiv papers through MCP. Once the server is running via uv tool, client code can call the built-in tools by name: search_papers, download_paper, list_papers, and read_paper. There is also a dedicated research-prompt workflow (deep-paper-analysis) to guide structured analysis of a paper by ID. This setup keeps a local storage of downloaded papers for quick access and re-use by subsequent queries or prompts.

To use the tools from your MCP client, call the corresponding tool names with the expected parameters. For example, search_papers supports query strings and optional filters like date_from and categories; download_paper retrieves a paper by its arXiv ID; list_papers returns available downloads; and read_paper fetches the content of a downloaded paper. The deep-paper-analysis prompt provides a comprehensive analysis flow that leverages these tools to produce an executive summary, context, methodology critique, results discussion, and future directions, all driven by a single paper ID.

Configuration is done through the MCP client config and environment variables (notably ARXIV_STORAGE_PATH). Ensure the storage path exists and is writable by the process running uv tool. With these tools, an AI assistant can perform end-to-end workflows—from discovering relevant papers to obtaining full text and generating structured analyses.

Prerequisites:

• Python 3.11+ installed on your system
• uv tool installed (via the Smithery workflow or pipx as a wrapper for arxiv-mcp-server)
• Git installed for cloning the repository if you plan to develop locally

1. Clone the repository (optional if you’re installing via uv):

git clone https://github.com/blazickjp/arxiv-mcp-server.git
cd arxiv-mcp-server

2. Set up a Python virtual environment and install development dependencies (for development or testing):

python -m venv .venv
source .venv/bin/activate
uv pip install -e ".[test]"  # or install dependencies as needed

3. Install the MCP server via uv tool (development or production run):

uv tool install arxiv-mcp-server

4. Prepare storage directory and environment variable:

• Create the storage path for downloaded papers, e.g. /path/to/paper/storage
• Ensure ARXIV_STORAGE_PATH (or the --storage-path flag) points to this directory

5. Run the MCP server using uv with the configured storage path:

uv tool run arxiv-mcp-server --storage-path /path/to/paper/storage

6. (Optional) If developing locally, you can run with the development configuration example:

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

Environment and configuration tips:

• The primary environment variable is ARXIV_STORAGE_PATH which points to where downloaded papers are stored locally. If not set, a default path is ~/.arxiv-mcp-server/papers may be used depending on deployment.
• Ensure the storage directory exists and has appropriate read/write permissions for the user running the UV tool.
• If you encounter network or arXiv API rate limits, consider implementing query throttling or cache results locally via the List Papers / Read Paper tools.
• When using the deep-paper-analysis prompt, provide a valid arXiv paper ID (e.g., 2401.12345). The workflow will guide the tool invocations to fetch data and perform analysis.
• This server is Python-based; ensure your environment uses a compatible Python version (3.11+ as indicated by the project).