arxiv-today-mcp 0.3.3

MCP server for browsing and searching arXiv papers by category

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

Tool	Parameters	Description
fetch_papers	category, date=None, num_days=3, max_results=100	Fetch recent papers from arXiv API and store in local database
count_papers_on_date	category, date	Count how many papers were published in a category on a specific date
query_papers	date=None, categories=None, title=None, entry_ids=None, fields=None, max_results=500	Query local database with flexible filtering and field selection
cleanup_papers	before_date=None, date=None, categories=None	Delete papers by date and/or category
get_stats	—	Paper counts by publication date and top categories

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