User Input:
$ARGUMENTS
Guide for setup arXiv MCP server via Docker MCP
- Determine setup context
Ask the user where they want to store the configuration:
Options:
Project level (shared via git) - Configuration tracked in version control, shared with team
-
CLAUDE.md updates go to: ./CLAUDE.md
Project level (personal preferences) - Configuration stays local, not tracked in git
-
CLAUDE.md updates go to: ./CLAUDE.local.md
-
Verify these files are listed in .gitignore , add them if not
User level (global) - Configuration applies to all projects for this user
- CLAUDE.md updates go to: ~/.claude/CLAUDE.md
Store the user's choice and use the appropriate paths in subsequent steps.
- Check if Docker MCP is available
First, verify that Docker MCP (MCP_DOCKER) is accessible by attempting to use mcp-find tool to search for servers.
If Docker MCP is NOT available:
-
Ask user to install Docker Desktop following instructions at: https://docs.docker.com/desktop/
-
After Docker Desktop is installed, guide user to connect MCP using: https://docs.docker.com/ai/mcp-catalog-and-toolkit/get-started/#claude-code
-
Once configured, ask user to restart Claude Code and run "continue" to resume setup
- Search and add paper-search MCP server
Write to user that regular arxiv-mcp-server is known to have issues, specifically is failing to initialize (EOF error during init). So we will use paper-search MCP server instead.
Use Docker MCP to find and add the paper-search MCP server which provides comprehensive academic paper search capabilities:
mcp-find query: "paper-search" mcp-add name: "paper-search" activate: true
This server provides access to multiple academic sources:
-
arXiv - preprints in physics, mathematics, computer science, etc.
-
PubMed - biomedical literature
-
bioRxiv/medRxiv - biology and medicine preprints
-
Semantic Scholar - AI-powered research tool
-
Google Scholar - broad academic search
-
IACR - cryptography research
-
CrossRef - DOI-based citation database
- Test the setup
Verify the server is working by searching for papers:
mcp-exec name: "search_arxiv" arguments: {"query": "test query", "max_results": 2}
- Update CLAUDE.md file
Use the path determined in step 1:
Once the paper-search MCP server is successfully set up, update CLAUDE.md file with the following content:
Use Paper Search MCP for Academic Research
Paper Search MCP is available via Docker MCP for searching and downloading academic papers.
Available tools:
search_arxiv- Search arXiv preprints (physics, math, CS, etc.)search_pubmed- Search PubMed biomedical literaturesearch_biorxiv/search_medrxiv- Search biology/medicine preprintssearch_semantic- Search Semantic Scholar with year filterssearch_google_scholar- Broad academic searchsearch_iacr- Search cryptography paperssearch_crossref- Search by DOI/citation
Download and read tools:
download_arxiv/read_arxiv_paper- Download/read arXiv PDFsdownload_biorxiv/read_biorxiv_paper- Download/read bioRxiv PDFsdownload_semantic/read_semantic_paper- Download/read via Semantic Scholar
Usage notes:
- Use
mcp-execto call tools, e.g.,mcp-exec name: "search_arxiv" arguments: {"query": "topic", "max_results": 10} - Downloaded papers are saved to
./downloadsby default - For Semantic Scholar, supports multiple ID formats: DOI, ARXIV, PMID, etc.
- Alternative: arxiv-mcp-server
If you specifically need the dedicated arXiv MCP server with additional features (deep analysis prompts, local storage management), you can try:
mcp-find query: "arxiv" mcp-config-set server: "arxiv-mcp-server" key: "storage_path" value: "/path/to/papers" mcp-add name: "arxiv-mcp-server" activate: true
Note: This server requires configuration of a storage path for downloaded papers.