MCP ArXiv Server

An MCP Server for accessing the arXiv API. Enables AI assistants to search papers, retrieve metadata, and access PDFs from arXiv.

Features

• 📚 Search arXiv papers by query

• 📄 Retrieve full paper metadata by ID

• 🔗 Direct links to abstract and PDF URLs

• 🚀 Fast XML parsing for Atom feed responses

• ✅ TypeScript with strict typing

Related MCP server: research-mcp

Installation

From npm (Recommended)

# Install via npm
npm install -g @alexgenovese/mcp-arxiv

# Or via pnpm
pnpm add -g @alexgenovese/mcp-arxiv

# Or via yarn
yarn add -g @alexgenovese/mcp-arxiv

Build from Source

git clone https://github.com/alexgenovese/mcp-arxiv.git
cd mcp-arxiv
npm install
npm run build

Installation via Smithery

# Install via smithery
npx smithery install @alexgenovese/mcp-arxiv

# Or stream via smithery
npx smithery stream @alexgenovese/mcp-arxiv

# Run locally with smithery
npx @smithery/cli r @alexgenovese/mcp-arxiv

Installation via Glama

# Glama provides MCP discovery and installation
npx glama install @alexgenovese/mcp-arxiv

Usage

Configure your MCP Client

Add the MCP server configuration to your MCP client (Cursor, VS Code, Claude Desktop, etc.):

Compiled version (recommended):

{
  "mcpServers": {
    "arxiv": {
      "command": "node",
      "args": ["./dist/index.js"]
    }
  }
}

Development version (with source rebuild):

{
  "mcpServers": {
    "arxiv": {
      "command": "npx",
      "args": ["tsx", "src/index.ts"],
      "cwd": "/path/to/mcp-arxiv"
    }
  }
}

Available Tools

The MCP server provides the following tools:

🔍 arxiv_search

Search for papers on arXiv by query.

{
  "name": "arxiv_search",
  "arguments": {
    "query": "machine learning neural networks",
    "start": 0,
    "max_results": 10,
    "sort_by": "relevance",
    "sort_order": "descending"
  }
}

Parameters:

• query: Search query string (required)

• start: Starting index for pagination (default: 0)

• max_results: Maximum number of results (default: 10, max: 20)

• sort_by: "relevance" or "lastUpdatedDate" (default: "relevance")

• sort_order: "ascending" or "descending" (default: "descending")

Returns: Array of papers with id, title, abstract, and URLs.

📄 arxiv_get_paper

Retrieves full metadata for a specific paper by ID.

{
  "name": "arxiv_get_paper",
  "arguments": {
    "id": "2401.00000"
  }
}

Parameters:

• id: arXiv paper ID (e.g., "2401.00000")

Returns: Full paper metadata including ID, title, authors, abstract, categories, and URLs.

📥 arxiv_get_feed

Retrieves papers from an arXiv category feed (RSS/Atom).

{
  "name": "arxiv_get_feed",
  "arguments": {
    "format": "atom",
    "category": "cs.AI",
    "limit": 20,
    "publishedInMonths": 3
  }
}

Parameters:

• format: "atom" or "rss" (default: "atom")

• category: arXiv category (e.g., "cs.AI", "physics", "quant-ph")

• limit: Maximum number of papers (default: 20)

• publishedInMonths: Papers from last N months (default: 12, max: 24)

Returns: Array of papers from the specified category.

🔗 arxiv_get_pdf_url

Retrieves canonical PDF URL for a paper ID.

{
  "name": "arxiv_get_pdf_url",
  "arguments": {
    "id": "2401.00000"
  }
}

Parameters:

• id: arXiv paper ID

Returns: PDF URL for the specified paper.

Development

# Install dependencies
npm install

# Run development server with type checking
npm run dev

# Build production version
npm run build

# Run tests
npm test

License

MIT License - see LICENSE file for details.

Contributing

Contributions are welcome! Please read our code of conduct before contributing.

1. Fork the repository

2. Create your feature branch (git checkout -b feature/AmazingFeature)

3. Commit your changes (git commit -m 'Add some AmazingFeature')

4. Push to the branch (git push origin feature/AmazingFeature)

5. Open a Pull Request

Acknowledgments

• Built with Model Context Protocol

• Data from arXiv API