mcp-arxiv-query

# ArXiv Query MCP Server The ArXiv Query MCP Server is a Model Context Protocol (MCP) implementation that provides AI assistants with capabilities to search, download, and extract text from academic papers on arXiv. ## Features - **Comprehensive Search Options**: Search arXiv papers by ID, author, category, title, abstract, or date range - **Paper Downloads**: Download papers as PDF files with automatic caching - **Text Extraction**: Convert downloaded PDFs to text with support for Mistral OCR API or local processing - **Rate Limiting**: Smart rate limiting to respect arXiv API usage policies ## Installation ### Prerequisites - Docker - Python 3.9+ - Pip package manager ### Docker Installation (Recommended) ```bash # Clone the repository git clone https://github.com/yourusername/mcp-arxiv-query.git cd mcp-arxiv-query # Build the Docker image docker build -t mcp-arxiv-query . # Test the server echo '{"jsonrpc":"2.0","id":1,"method":"list_tools","params":{}}' | \ docker run --rm -i mcp-arxiv-query ``` ### Local Installation ```bash # Clone the repository git clone https://github.com/yourusername/mcp-arxiv-query.git cd mcp-arxiv-query # Install dependencies with uv (recommended) uv pip install . # Or install with pip pip install . # Run the server python -m mcp_arxiv_query ``` ## Usage with Claude Desktop Add the ArXiv Query MCP server to your Claude Desktop configuration file. ### Basic Configuration ```json { "mcp_servers": { "arxiv-query": { "command": "docker", "args": [ "run", "--rm", "-i", "-v", "$HOME/Downloads:/app/Downloads", "mcp-arxiv-query" ] } } } ``` ### Advanced Configuration with OCR Support ```json { "mcp_servers": { "arxiv-query": { "command": "docker", "args": [ "run", "--rm", "-i", "-e", "MISTRAL_OCR_API_KEY=your_api_key_here", "-e", "ARXIV_MAX_CALLS_PER_MINUTE=30", "-e", "ARXIV_MAX_C…