Skip to main content

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

Project description

mcp-simple-arxiv

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

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)

The server implements proper rate limiting according to arXiv's API guidelines (max 1 request every 3 seconds).

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)

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

mcp_simple_arxiv-0.2.1.tar.gz (12.1 kB view details)

Uploaded Source

Built Distribution

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

mcp_simple_arxiv-0.2.1-py3-none-any.whl (13.6 kB view details)

Uploaded Python 3

File details

Details for the file mcp_simple_arxiv-0.2.1.tar.gz.

File metadata

  • Download URL: mcp_simple_arxiv-0.2.1.tar.gz
  • Upload date:
  • Size: 12.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.0.1 CPython/3.11.3

File hashes

Hashes for mcp_simple_arxiv-0.2.1.tar.gz
Algorithm Hash digest
SHA256 e98aee31bb0279ba2a544cd9ee0b487403a3a5a4bf9c2575aac068625412315d
MD5 77aa4bba966a7b75f782c12e26049d57
BLAKE2b-256 ee1b0bb3f72d0ccd95dd646b8fa2c735b2d7b02fda235c651348978ff985d997

See more details on using hashes here.

File details

Details for the file mcp_simple_arxiv-0.2.1-py3-none-any.whl.

File metadata

File hashes

Hashes for mcp_simple_arxiv-0.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 8bcf1dd521099f4acaefb57eed9319e62a018b4d504acb452b3e276712f2c913
MD5 7479d49f4c800f6b0dc67271323efd83
BLAKE2b-256 0e58b1e5766f6020aa26de7476e2b5dcd85179b38bb050845b548aa0fc5277d3

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