How blazickjp/arxiv-mcp-server works
Main Components
a) External Systems:
• ArXiv API (external service)
• AI Assistants (clients)
• Local File System (for paper storage)
b) Core Server Components:
• MCP Server Interface
• Tool Handlers
• Paper Management System
• Storage Management
Component Organization
Client Layer
• ↓
Interface Layer
• ↓
Service Layer
• ↓
Storage Layer
• ↓
External Service Layer
Specific Component Details
a) Interface Layer:
• MCP Server component (server.py)
• Four main tools as sub-components:
• Search Tool (search.py)
• Download Tool (download.py)
• Papers Tool (list_papers.py)
• Read Paper Tool (read_paper.py)
b) Service Layer:
• Paper Resource Manager (papers.py)
• Configuration Management (config.py)
c) Storage Layer:
• Local Paper Storage System
• Storage Path Management
Important Elements to Highlight
• MCP Protocol interface
• Paper storage path configuration
• Tool interaction flows
• External API communication patterns
• Local storage management
Create clear boundaries between:
• External interfaces
• Core server logic
• Storage management
• Tool implementations
Additional Details
Annotations for:
• Configuration options
• Storage paths
• Supported paper formats
• API endpoints
• The modular nature of the tool system
• Clear separation between interface and implementation
• Storage management strategy
• External service integration
Remember to:
• Keep the main flow clear and easy to follow
• Version information and key dependencies
• Significant configuration requirements