arXiv Research

by andybrandt

Recommended
71 stars
76.7k downloads
Not rated
GitHub

About

Search and retrieve academic papers from the arXiv repository via its API.

Details

Author
andybrandt
Repository
andybrandt/mcp-simple-arxiv
GitHub stars
71
Downloads
76,741
License
MIT License
Categories
Search, Other
Tags
#learning, #education, #research

This server allows LLM clients (like Claude Desktop) to:
- Search for scientific papers on arXiv by title and abstract content
- Filter search results by submission date range
- Control search result sorting (by submission date, update date, or relevance)
- See total matching results count to gauge search specificity
- Get paper metadata and abstracts
- Retrieve full paper text as Markdown (converted from PDF)
- Access links to available paper formats (PDF/HTML)
- Browse and search arXiv subject categories

To use the web version just add this connector to Claude.ai https://mcp.andybrandt.net/arxiv .
You can also install & use it locally.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name arXiv Research
    Command (node, npx, python, etc.) python
    Arguments
    • Argument 1 -m
    • Argument 2 mcp_simple_arxiv

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

This server can be run in two modes: as a local stdio server for desktop clients or as a network-accessible web server.

To install Simple Arxiv for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install mcp-simple-arxiv --client claude
pip install mcp-simple-arxiv

Add this configuration to your claude_desktop_config.json:

(Mac OS)

{
  "mcpServers": {
    "simple-arxiv": {
      "command": "python",
      "args": ["-m", "mcp_simple_arxiv"]
      }
  }
}

(Windows version):

{
  "mcpServers": {
    "simple-arxiv": {
      "command": "C:\\Users\\YOUR_USERNAME\\AppData\\Local\\Programs\\Python\\Python311\\python.exe",
      "args": [
        "-m",
        "mcp_simple_arxiv"
      ]
    }
  }
}

After restarting Claude Desktop, the following capabilities will be available:

Once you have a paper ID, you can ask for more details:

Can you show me the details for paper 2103.08220?

This will return:
- Full paper title
- Authors
- Publication and update dates
- Journal reference (if available)
- Paper abstract
- Links to available formats (PDF/HTML)

For web deployment see WEB_DEPLOYMENT.md.

search_papers

Search for scientific papers on arXiv by title and abstract content. Parameters: query (string)

filter_search_results

Filter search results by submission date range. Parameters: start_date (string), end_date (string)

sort_search_results

Control search result sorting by submission date, update date, or relevance. Parameters: sort_by (string)

get_total_matching_results

See total matching results count to gauge search specificity.

get_paper_metadata

Get paper metadata and abstracts using the paper ID. Parameters: paper_id (string)

retrieve_full_paper_text

Retrieve full paper text as Markdown (converted from PDF). Parameters: paper_id (string)

access_paper_links

Access links to available paper formats (PDF/HTML) using the paper ID. Parameters: paper_id (string)

browse_arxiv_categories

Browse and search arXiv subject categories.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "arxiv research": {
            "env": {},
            "args": [
                "-m",
                "mcp_simple_arxiv"
            ],
            "command": "python"
        }
    }
}

Linux

{
    "env": [],
    "args": [
        "-m",
        "mcp_simple_arxiv"
    ],
    "command": "python"
}

Macos

{
    "env": [],
    "args": [
        "-m",
        "mcp_simple_arxiv"
    ],
    "command": "python"
}

Windows

{
    "env": [],
    "args": [
        "-m",
        "mcp_simple_arxiv"
    ],
    "command": "C:\\Users\\YOUR_USERNAME\\AppData\\Local\\Programs\\Python\\Python311\\python.exe"
}

mcp-simple-arxiv

Trust Score
smithery badge
Verified on MseeP

An MCP server that provides access to arXiv papers through their API.

<a href="https://glama.ai/mcp/servers/p38q3nagwb">mcp-simple-arxiv MCP server</a>

Features

This server allows LLM clients (like Claude Desktop) to:
- Search for scientific papers on arXiv by title and abstract content
- Filter search results by submission date range
- Control search result sorting (by submission date, update date, or relevance)
- See total matching results count to gauge search specificity
- Get paper metadata and abstracts
- Retrieve full paper text as Markdown (converted from PDF)
- Access links to available paper formats (PDF/HTML)
- Browse and search arXiv subject categories

To use the web version just add this connector to Claude.ai https://mcp.andybrandt.net/arxiv .
You can also install & use it locally.

Installation and Deployment

This server can be run in two modes: as a local stdio server for desktop clients or as a network-accessible web server.

Installing via Smithery

To install Simple Arxiv for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install mcp-simple-arxiv --client claude

Manual Installation

pip install mcp-simple-arxiv

Usage with Claude Desktop

Add this configuration to your claude_desktop_config.json:

(Mac OS)

{
  "mcpServers": {
    "simple-arxiv": {
      "command": "python",
      "args": ["-m", "mcp_simple_arxiv"]
      }
  }
}

(Windows version):

{
  "mcpServers": {
    "simple-arxiv": {
      "command": "C:\\Users\\YOUR_USERNAME\\AppData\\Local\\Programs\\Python\\Python311\\python.exe",
      "args": [
        "-m",
        "mcp_simple_arxiv"
      ]
    }
  }
}

After restarting Claude Desktop, the following capabilities will be available:

Searching Papers

You can ask Claude to search for papers using queries like:

Can you search arXiv for recent papers about large language models?

The LLM can sort results by submission date, update date, or relevance:

Search arXiv for papers about transformers, sorted by relevance.

Date filtering lets you focus on specific time periods:

Find papers about quantum computing published in 2024.
Search for recent machine learning papers from the last 6 months.

Search results include:
- Total number of matching papers (e.g., "Found 15,234 total results, showing first 10")
- Paper title, authors, and arXiv ID
- Categories (primary and additional)
- Publication date
- Abstract preview

Getting Paper Details

Once you have a paper ID, you can ask for more details:

Can you show me the details for paper 2103.08220?

This will return:
- Full paper title
- Authors
- Publication and update dates
- Journal reference (if available)
- Paper abstract
- Links to available formats (PDF/HTML)

For web deployment see WEB_DEPLOYMENT.md.

Development

To install for development:

git clone https://github.com/andybrandt/mcp-simple-arxiv
cd mcp-simple-arxiv
pip install -e .

arXiv API Guidelines

This server follows arXiv API usage guidelines:
- Rate limiting to max 1 request per 3 seconds
- Single connection at a time
- Proper error handling and retry logic

License

MIT

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.