https://github.com/MCP-Mirror/blazickjp_arxiv-mcp-server
Mirror of https://github.com/blazickjp/arxiv-mcp-server
https://github.com/MCP-Mirror/blazickjp_arxiv-mcp-server
Last synced: 3 months ago
JSON representation
Mirror of https://github.com/blazickjp/arxiv-mcp-server
- Host: GitHub
- URL: https://github.com/MCP-Mirror/blazickjp_arxiv-mcp-server
- Owner: MCP-Mirror
- License: apache-2.0
- Created: 2024-12-25T20:10:26.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2024-12-25T20:10:31.000Z (11 months ago)
- Last Synced: 2024-12-25T20:27:31.865Z (11 months ago)
- Language: Python
- Size: 0 Bytes
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp-servers - **blazickjp_arxiv-mcp-server** - Mirror of https://github.com/blazickjp/arxiv-mcp-server `python` `mcp` `server` `http` `pip install git+https://github.com/MCP-Mirror/blazickjp_arxiv-mcp-server` (🤖 AI/ML)
README
[](https://www.python.org/downloads/)
[](https://opensource.org/licenses/MIT)
# ArXiv MCP Server
> 🔍 Enable AI assistants to search and access arXiv papers through a simple MCP interface.
The ArXiv MCP Server provides a bridge between AI assistants and arXiv's research repository through the Message Control Protocol (MCP). It allows AI models to search for papers and access their content in a programmatic way.
🤝 **[Contribute](https://github.com/blazickjp/arxiv-mcp-server/blob/main/CONTRIBUTING.md)** •
📝 **[Report Bug](https://github.com/blazickjp/arxiv-mcp-server/issues)**
## ✨ Core Features
- 🔎 **Paper Search**: Query arXiv papers with filters for date ranges and categories
- 📄 **Paper Access**: Download and read paper content
- 📋 **Paper Listing**: View all downloaded papers
- 🗃️ **Local Storage**: Papers are saved locally for faster access
## 🚀 Quick Start
Install using uv:
```bash
uv pip install git+https://github.com/blazickjp/arxiv-mcp-server.git
```
For development:
```bash
# Clone and set up development environment
git clone https://github.com/blazickjp/arxiv-mcp-server.git
cd arxiv-mcp-server
# Create and activate virtual environment
uv venv
source .venv/bin/activate
# Install with test dependencies
uv pip install -e ".[test]"
```
### 🔌 MCP Integration
Add this configuration to your MCP client config file:
```json
{
"mcpServers": {
"arxiv-mcp-server": {
"command": "uv",
"args": [
"run",
"arxiv-mcp-server",
"--storage-path", "/path/to/paper/storage"
]
}
}
}
```
## 💡 Available Tools
The server provides four main tools:
### 1. Paper Search
Search for papers with optional filters:
```python
result = await call_tool("search_papers", {
"query": "transformer architecture",
"max_results": 10,
"date_from": "2023-01-01",
"categories": ["cs.AI", "cs.LG"]
})
```
### 2. Paper Download
Download a paper by its arXiv ID:
```python
result = await call_tool("download_paper", {
"paper_id": "2401.12345"
})
```
### 3. List Papers
View all downloaded papers:
```python
result = await call_tool("list_papers", {})
```
### 4. Read Paper
Access the content of a downloaded paper:
```python
result = await call_tool("read_paper", {
"paper_id": "2401.12345"
})
```
## ⚙️ Configuration
Configure through environment variables:
| Variable | Purpose | Default |
|----------|---------|---------|
| `ARXIV_STORAGE_PATH` | Paper storage location | ~/.arxiv-mcp-server/papers |
## 🧪 Testing
Run the test suite:
```bash
python -m pytest
```
## 📄 License
Released under the MIT License. See the LICENSE file for details.
---
Made with ❤️ by the Pear Labs Team
