arxiv

arxiv-mcp-server provides an MCP-based interface to search, analyze, and export arXiv papers. It combines fast semantic discovery with AI-assisted summaries, citation analysis, and trend tracking, and can export results in BibTeX, RIS, JSON, CSV, YAML, and PDF-ready summaries. The server exposes a REST API and a CLI, enabling programmatic access for dashboards, notebooks, and automation pipelines. Use the API to perform advanced searches, retrieve contextual paper data, run analyses, and generate multi-format exports suitable for literature reviews or dashboards. The built-in AI assistant layer helps assemble prompts, summarize findings, and propose next steps based on your query context.

Prerequisites:

• Docker installed and running, or a compatible container runtime
• Optional: an arXiv API key if you plan to access restricted data or rate-limited endpoints
• Sufficient disk space for paper data, indices, and exports

Step-by-step installation (Docker):

# Pull the latest image (if not already available locally)
docker pull arxiv-mcp-server:latest

# Run the MCP server (exposes API on port 8080)
docker run -it --rm -p 8080:8080 arxiv-mcp-server:latest

Alternative: if you have a local artifact bundle, unpack it and run the provided startup script following the package-specific instructions in the bundle (typically a setup.sh or install.ps1).

Post-install checks:

• Confirm the service is listening on port 8080 (or the configured port).
• Check logs for startup confirmation and any configuration guidance.
• Send a basic API request to verify availability, e.g., a simple search endpoint.

Tips and common issues:

• If you encounter port conflicts, adjust the host-port mapping in your docker run command (e.g., -p 8081:8080).
• If API rate limits from arXiv are hit, consider supplying an API key if supported by the bundle and staggering requests.
• Use environment variables to tailor logging, data directories, and AI prompt behavior (MCP_LOG_LEVEL, DATA_DIR, etc.).
• For large-scale usage, consider Docker Compose or Kubernetes deployment with persistent volumes for data and indices.
• When exporting, ensure the target formats (BibTeX, RIS, JSON, CSV, YAML) are enabled in your configuration and that your consumer applications can parse the chosen format.