Skip to content

Commit 5f1c6cc

Browse files
authored
Add ArXiv MCP Server for academic research and paper analysis (#66)
* Add ArXiv MCP Server for academic research and paper analysis Features: • Search arXiv papers with advanced filtering (date, category, query) • Download and store papers locally as markdown • Read and analyze paper content programmatically • Deep research analysis prompts for comprehensive paper review • Configurable local storage path for paper management Technical Details: - Category: search (academic research focused) - License: Apache 2.0 (compatible with Docker registry) - Source: https://github.com/jasonleinart/arxiv-mcp-server - Build Status: Successfully tested and validated - Docker Image: mcp/arxiv-mcp-server Target Users: Perfect for researchers, academics, and AI assistants conducting literature reviews, research analysis, and academic paper exploration. Differentiates from existing paper-search server by providing: - ArXiv-specific optimizations and direct API integration - Local paper storage and management capabilities - Research-focused analysis prompts and workflows - Advanced filtering and categorization options * FIX: Add proper volume mounting to ArXiv MCP server - Maps user storage path to /app/papers inside container - Enables file persistence for downloaded papers - Fixes ephemeral container issue where files weren't saved - Follows pattern used by kubectl-mcp-server and elevenlabs - Essential for Docker MCP Toolkit volume mounting * FIX: Use environment variable for volume mounting - Change from parameter template to environment variable approach - Docker MCP Toolkit processes but not {{parameter}} templates - Maps storage_path parameter to STORAGE_PATH env var for volume mounting - Should resolve volume mounting issue where files weren't persisting * FIX: Correct volume mounting configuration per PR feedback - Change volume mapping from $STORAGE_PATH to {{arxiv-mcp-server.storage_path}} template syntax - Add ARXIV_STORAGE_PATH environment variable for internal container path - Fixes volume mounting issue identified by @cmrigney in PR review - Follows Docker MCP Registry configuration standards per docs/configuration.md * FIX: Apply reviewer's suggestion - Use only ARXIV_STORAGE_PATH environment variable - Remove redundant STORAGE_PATH environment variable as suggested by @cmrigney - Keep only ARXIV_STORAGE_PATH with '/app/papers' value for container internal path - Simplifies configuration while maintaining full functionality - Volume mounting handles path mapping: {{arxiv-mcp-server.storage_path}}:/app/papers - ArXiv server auto-detects Docker environment and uses correct storage path
1 parent 042efe6 commit 5f1c6cc

File tree

1 file changed

+46
-0
lines changed

1 file changed

+46
-0
lines changed

servers/arxiv-mcp-server/server.yaml

Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,46 @@
1+
name: arxiv-mcp-server
2+
image: mcp/arxiv-mcp-server
3+
type: server
4+
meta:
5+
category: search
6+
tags:
7+
- arxiv
8+
- research
9+
- academic
10+
- papers
11+
- search
12+
- ai
13+
about:
14+
title: ArXiv MCP Server
15+
description: |
16+
The ArXiv MCP Server provides a comprehensive bridge between AI assistants and arXiv's research repository through the Model Context Protocol (MCP).
17+
18+
Features:
19+
• Search arXiv papers with advanced filtering
20+
• Download and store papers locally as markdown
21+
• Read and analyze paper content
22+
• Deep research analysis prompts
23+
• Local paper management and storage
24+
25+
Perfect for researchers, academics, and AI assistants conducting literature reviews and research analysis.
26+
icon: https://avatars.githubusercontent.com/u/15390319?v=4
27+
source:
28+
project: https://github.com/jasonleinart/arxiv-mcp-server
29+
run:
30+
volumes:
31+
- '{{arxiv-mcp-server.storage_path}}:/app/papers'
32+
config:
33+
description: Configure local storage path for downloaded papers
34+
env:
35+
- name: ARXIV_STORAGE_PATH
36+
example: /Users/local-test/papers
37+
value: '/app/papers'
38+
parameters:
39+
type: object
40+
properties:
41+
storage_path:
42+
type: string
43+
description: Directory path where downloaded papers will be stored
44+
default: /Users/local-test/papers
45+
required:
46+
- storage_path

0 commit comments

Comments
 (0)