Skip to main content

MCP server for querying, retrieving, and reading arXiv papers

Project description

arxiv-query-mcp

An MCP (Model Context Protocol) server that gives AI assistants direct access to arXiv. Search papers, retrieve full metadata, browse categories, and read paper text.

Table of Contents

  1. Features
  2. Installation
  3. Usage
  4. Contributing

Features

  • Search arXiv — Full query syntax support with title, author, abstract, and category filters
  • Get paper metadata — Retrieve complete details for any paper by ID (abstract, authors, categories, DOI, links)
  • Browse by category — List recent papers in specific subject areas (ML, AI, NLP, Computer Vision, etc.)
  • Read paper text — Fetch HTML-rendered paper content or fallback to abstracts with links
  • Flexible formatting — Response support for both markdown (human-readable) and JSON (programmatic)
  • Pagination — Handle large result sets with configurable limits and offsets

Installation

Prerequisites

  • Python 3.11 or later
  • Dependencies mcp[cli]>=1.0.0, httpx>=0.27.0, pydantic>=2.0.0 (see pyproject.toml) (project uses uv for dependency management)

Install from PyPI

pip install arxiv-query-mcp

Build from Source

git clone https://github.com/LWaetzig/google-scholar-mcp.git
cd google-scholar-mcp
pip install -e .

Usage

  • Detailed documentation about single tools can be found here

Integration with Claude Desktop

Add the server to your Claude Desktop configuration:

Platform Path
macOS ~/Library/Application Support/Claude/claude_desktop_config.json
Windows %APPDATA%\Claude\claude_desktop_config.json

Add the arxiv entry under mcpServers, replacing the path with the absolute path to your clone:

{
  "mcpServers": {
    "arxiv": {
      "command": "python",
      "args": ["-m", "arxiv-query-mcp"]
    }
  }
}

Restart Claude Desktop. You should see the arxiv tools available in the tool picker.

Integration with Other MCP Clients

Any MCP client (e.g., Cline, Continue, or custom tools) can use this server. Configure the connection to:

Command: python -m arxiv-query-mcp.server
Transport: stdio

Contributing

Contributions are welcome! Please:

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/your-feature)
  3. Commit your changes with clear messages
  4. Push to your fork
  5. Open a pull request

Support

For issues, questions, or feature requests, please open an issue on GitHub.

License

See LICENSE file

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

arxiv_query_mcp-0.1.0.tar.gz (11.5 kB view details)

Uploaded Source

Built Distribution

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

arxiv_query_mcp-0.1.0-py3-none-any.whl (13.9 kB view details)

Uploaded Python 3

File details

Details for the file arxiv_query_mcp-0.1.0.tar.gz.

File metadata

  • Download URL: arxiv_query_mcp-0.1.0.tar.gz
  • Upload date:
  • Size: 11.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for arxiv_query_mcp-0.1.0.tar.gz
Algorithm Hash digest
SHA256 7d38e2993c32065c9b95ee7bfea4f36aa9989f8152b41ee1e9dc1f8dc5534b0a
MD5 09852d82fd3faed3e71d2a16e4967cb6
BLAKE2b-256 5442fc61e313e8cbbefc0ee080e1bb9adda21d507f7d351d57535b269ef834a7

See more details on using hashes here.

Provenance

The following attestation bundles were made for arxiv_query_mcp-0.1.0.tar.gz:

Publisher: pypi-release.yml on LWaetzig/arxiv-query-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file arxiv_query_mcp-0.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for arxiv_query_mcp-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 3a21b1dcec531fb3b6e2dbbd3caf0efcf1621c6ef87c29efac7f5d0eb10dd1a3
MD5 95536a7cfbf02cd79d5c69a7e1098cd0
BLAKE2b-256 6995b05b2cf49b5bd665bab8b83292b8efaf6295a7dcffef91adcd69effb91cb

See more details on using hashes here.

Provenance

The following attestation bundles were made for arxiv_query_mcp-0.1.0-py3-none-any.whl:

Publisher: pypi-release.yml on LWaetzig/arxiv-query-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

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