Skip to main content

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

Project description

mcp-simple-arxiv

Trust Score smithery badge Verified on MseeP

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

mcp-simple-arxiv MCP server

Features

This server allows LLM clients (like Claude Desktop) to:

  • Search for scientific papers on arXiv by title and abstract content
  • Get paper metadata and abstracts
  • Access links to available paper formats (PDF/HTML)

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 search will return basic information about matching papers including:

  • Paper title
  • Authors
  • arXiv ID
  • Publication date

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 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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

iflow_mcp_mcp_simple_arxiv-0.3.0.tar.gz (10.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

iflow_mcp_mcp_simple_arxiv-0.3.0-py3-none-any.whl (13.7 kB view details)

Uploaded Python 3

File details

Details for the file iflow_mcp_mcp_simple_arxiv-0.3.0.tar.gz.

File metadata

File hashes

Hashes for iflow_mcp_mcp_simple_arxiv-0.3.0.tar.gz
Algorithm Hash digest
SHA256 9ff3f3ebe6083e62f1d772c7c18d9b6044242ecee0823b54999f719ad7a305f7
MD5 3c41ebf60e80ddfac812f21d7337fe1d
BLAKE2b-256 9586a98dbac6f95b63ce679c850e38dc115531b7b03d4a872d904c228d849080

See more details on using hashes here.

File details

Details for the file iflow_mcp_mcp_simple_arxiv-0.3.0-py3-none-any.whl.

File metadata

File hashes

Hashes for iflow_mcp_mcp_simple_arxiv-0.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 9496d2d3ab6860bb00f713baef5ee9d86f87049a5e1f67c8d7d418c6a9b8702c
MD5 88822922d2e04376898be23baea39d2b
BLAKE2b-256 f365a08b0771568a92c54d4f5f55ee55054a85116a25cd4b157ec3c3a3f24e4a

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page