Arxiv Semantic Search
@icyclv
A lightweight MCP server that lets AI assistants query the arXiv API. It provides two powerful search approaches:
Overview
What is Arxiv Semantic Search?
A lightweight Model Context Protocol (MCP) server that lets AI assistants query the arXiv API. It offers two search approaches: semantic search using vector embeddings (currently limited to Computer Science cs.* categories) and keyword search with structured filters across all arXiv categories.
How to use Arxiv Semantic Search?
Clone the repository, install dependencies with uv sync, and start the server with uv run main.py. Then configure your AI client (e.g., Claude Desktop) by adding a JSON block pointing to the server’s directory and the uv run main.py command.
Key features of Arxiv Semantic Search
- Semantic search using vector embeddings for natural language queries
- Keyword search with multiple filters and date ranges
- Retrieve detailed paper information by arXiv ID
- Get a list of available arXiv categories
- Requires Python 3.12+ and the uv package manager
Use cases of Arxiv Semantic Search
- Query recent advances in vision transformers for medical image segmentation
- Search machine learning papers with date and category filters
- Retrieve full details for a specific paper by its arXiv ID
- Explore arXiv categories and their descriptions
FAQ from Arxiv Semantic Search
What is the difference between semantic and keyword search?
Semantic search uses embeddings to understand query meaning but currently only supports cs.* categories. Keyword search uses structured queries and supports all arXiv categories.
What runtime dependencies are required?
Python 3.12 or higher and the uv package manager (dependency resolver & runner).
How do I configure this server with an AI assistant?
Add a JSON configuration under mcpServers specifying the command uv with arguments --directory /path/to/arxiv-semantic-search-mcp run main.py.
Can I search papers from all arXiv categories?
Yes, the keyword search function supports all categories. The semantic search is limited to Computer Science (cs.*) categories.
What functions does the server expose?
Five functions: search_semantic, search_keyword, get_details, get_categories, and get_current_time.
