ArXiv MCP Server

ArXiv MCP Server

🔍 Permite a los asistentes de IA buscar y acceder a artículos de arXiv a través de una interfaz MCP sencilla.

El servidor ArXiv MCP proporciona un puente entre los asistentes de IA y el repositorio de investigación de arXiv a través del Protocolo de Control de Mensajes (MCP). Permite a los modelos de IA buscar artículos y acceder a su contenido de forma programática.

✨ Características Principales

• 🔎 Búsqueda de Artículos: Consulta artículos de arXiv con filtros por rangos de fechas y categorías
• 📄 Acceso a Artículos: Descarga y lee el contenido de los artículos
• 📋 Listado de Artículos: Visualiza todos los artículos descargados
• 🗃️ Almacenamiento Local: Los artículos se guardan localmente para un acceso más rápido
• 📝 Prompts: Un conjunto de prompts de investigación

🚀 Inicio Rápido

Instalación mediante Smithery

Para instalar ArXiv Server para Claude Desktop automáticamente mediante Smithery:

npx -y @smithery/cli install arxiv-mcp-server --client claude

Instalación Manual

Instala usando uv:

uv tool install arxiv-mcp-server

Para desarrollo:

# 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]"

🔌 Integración MCP

Añade esta configuración al archivo de configuración de tu cliente MCP:

{
    "mcpServers": {
        "arxiv-mcp-server": {
            "command": "uv",
            "args": [
                "tool",
                "run",
                "arxiv-mcp-server",
                "--storage-path", "/path/to/paper/storage"
            ]
        }
    }
}

Para desarrollo:

{
    "mcpServers": {
        "arxiv-mcp-server": {
            "command": "uv",
            "args": [
                "--directory",
                "path/to/cloned/arxiv-mcp-server",
                "run",
                "arxiv-mcp-server",
                "--storage-path", "/path/to/paper/storage"
            ]
        }
    }
}

💡 Herramientas Disponibles

El servidor proporciona cuatro herramientas principales:

1. Búsqueda de Artículos

Busca artículos con filtros opcionales:

result = await call_tool("search_papers", {
    "query": "transformer architecture",
    "max_results": 10,
    "date_from": "2023-01-01",
    "categories": ["cs.AI", "cs.LG"]
})

2. Descarga de Artículos

Descarga un artículo por su ID de arXiv:

result = await call_tool("download_paper", {
    "paper_id": "2401.12345"
})

3. Listar Artículos

Visualiza todos los artículos descargados:

result = await call_tool("list_papers", {})

4. Leer Artículo

Accede al contenido de un artículo descargado:

result = await call_tool("read_paper", {
    "paper_id": "2401.12345"
})

⚙️ Configuración

Configura mediante variables de entorno:

Variable	Propósito	Predeterminado
ARXIV_STORAGE_PATH	Ubicación de almacenamiento de artículos	~/.arxiv-mcp-server/papers

🧪 Pruebas

Ejecuta el conjunto de pruebas:

python -m pytest

📄 Licencia

Publicado bajo la Licencia MIT. Consulta el archivo LICENSE para más detalles.

---