arXiv MCP Server

An MCP (Model Context Protocol) server that lets LLMs like Claude search and fetch arXiv papers directly.

中文文档

Features

• Fetch recent papers from any arXiv category and store them locally
• Query papers with flexible filtering by date, category, title, and entry ID
• Retrieve full abstracts on demand for papers of interest
• Clean up old papers from the local database
• Database statistics by publication date and category

Tools

Design principle: fetch_papers and query_papers return only titles and metadata by default to save context. Use query_papers(fields=["abstract"]) when you need abstracts for specific papers.

Installation

Claude Code (recommended)

Add to your ~/.claude.json under mcpServers:

{
  "mcpServers": {
    "arxiv": {
      "command": "uvx",
      "args": ["arxiv-today-mcp"],
      "type": "stdio"
    }
  }
}

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "arxiv": {
      "command": "uvx",
      "args": ["arxiv-today-mcp"]
    }
  }
}

Usage Example

1. Browse today's papers: Ask Claude "What's new in cs.AI today?" — Claude will call fetch_papers then query_papers, returning titles grouped by topic.
2. Get details: "Tell me more about papers 2 and 5" — Claude will call query_papers with those entry IDs and fields=["abstract"] to summarize the abstracts.

Configuration

The database path can be overridden with an environment variable:

{
  "mcpServers": {
    "arxiv": {
      "command": "uvx",
      "args": ["arxiv-today-mcp"],
      "env": {
        "ARXIV_MCP_DB_PATH": "/your/custom/path/papers.db"
      }
    }
  }
}

Requirements

• Python >= 3.10
• uv or uvx