Skip to main content
Glama

arXiv Research MCP

Un servidor MCP de solo lectura y desplegable para la investigación de literatura científica.

ChatGPT
   ↓  Streamable HTTP
arXiv Research MCP
   ↓  official Atom API
arXiv scientific papers

El servidor recupera y normaliza metadatos. ChatGPT sigue siendo responsable de explicar la física, comparar artículos y resolver ecuaciones.

Herramientas

Herramienta

Uso

search_arxiv

Búsqueda general por palabras clave o búsqueda avanzada en arXiv con paginación y ordenación

get_arxiv_paper

Metadatos completos de un ID de arXiv moderno o heredado

search_arxiv_by_author

Artículos de un autor determinado

search_arxiv_by_category

Búsqueda por categoría con palabras clave opcionales

get_recent_arxiv_papers

Envíos más recientes en una categoría

Cada herramienta está marcada como de solo lectura y devuelve datos estructurados tipados que contienen el ID de arXiv, el título y el resumen normalizados, autores, categorías, fechas, DOI, referencia de la revista, URL del resumen y URL del PDF cuando estén disponibles.

Related MCP server: arXiv MCP Server

Configuración local

Requiere Python 3.11 o superior.

py -m venv .venv
.venv\Scripts\Activate.ps1
python -m pip install --upgrade pip
python -m pip install -e ".[dev]"
Copy-Item .env.example .env

Edita ARXIV_USER_AGENT en .env y sustituye el contacto de ejemplo por tu correo electrónico o la URL del proyecto. arXiv no requiere una clave de API.

Ejecuta localmente a través de stdio:

arxiv-mcp

Ejecuta localmente el transporte compatible con el modo remoto:

arxiv-mcp --transport streamable-http --host 127.0.0.1 --port 8000

Los endpoints son:

http://127.0.0.1:8000/mcp
http://127.0.0.1:8000/health

Para probar una herramienta manualmente, inicia el servidor HTTP, ejecuta el MCP Inspector oficial y conéctalo a http://127.0.0.1:8000/mcp:

npx @modelcontextprotocol/inspector@latest

Ejecutar pruebas

pytest
ruff check .

Las pruebas usan respuestas HTTP simuladas y no consumen la API de arXiv. GitHub Actions ejecuta las mismas comprobaciones en cada push y pull request.

Fiabilidad y seguridad

  • Upstream fijo en la lista de permitidos: https://export.arxiv.org/api/query

  • Espaciado global de solicitudes de tres segundos por defecto

  • Reintentos limitados para tiempos de espera, fallos de red, HTTP 429 y respuestas 5xx temporales

  • Validación estricta de resultados, offset, categoría, ordenación e ID de arXiv

  • Análisis XML seguro con entidades externas deshabilitadas

  • Sin ejecución de shell, obtención arbitraria de URLs, secretos, operaciones de escritura ni almacenamiento de datos de usuario

  • Despliegue Streamable HTTP sin estado

Desplegar en Render

El repositorio incluye un Dockerfile no root y un Blueprint render.yaml.

  1. Sube este repositorio a GitHub.

  2. Inicia sesión en Render y selecciona Nuevo → Blueprint.

  3. Conecta el repositorio de GitHub y aplica render.yaml.

  4. En el entorno del servicio de Render, cambia ARXIV_USER_AGENT para que incluya tu correo electrónico real o la URL del repositorio.

  5. Espera a que /health pase correctamente y luego copia la URL del servicio.

La URL final del MCP es:

https://<your-render-service>.onrender.com/mcp

El Blueprint usa la instancia gratuita de Render, por lo que el despliegue no crea silenciosamente un compromiso de facturación. Render documenta que los servicios gratuitos entran en reposo después de 15 minutos de inactividad y pueden tardar alrededor de un minuto en reiniciarse. Ese arranque en frío puede superar el tiempo de espera de un cliente MCP; mejora el servicio a starter o a otra instancia de pago antes de depender de él como conector de producción siempre disponible. Consulta las limitaciones del plan gratuito de Render y la referencia de Blueprint.

Conectar con ChatGPT

Estos pasos siguen la documentación oficial actual de OpenAI:

  1. Despliega el servidor y confirma que la URL HTTPS pública /mcp funciona en MCP Inspector.

  2. En ChatGPT, abre Configuración → Seguridad e inicio de sesión y habilita el Modo de desarrollador.

  3. Abre ChatGPT Plugins y selecciona el botón +.

  4. Introduce:

    • Nombre: arXiv Research

    • Descripción: Read-only search and metadata retrieval from the official arXiv API.

    • Conexión: endpoint MCP público

    • URL del servidor: https://<your-render-service>.onrender.com/mcp

    • Autenticación: ninguna

  5. Crea la conexión y confirma que se detectan exactamente cinco herramientas.

  6. Inicia un nuevo chat y añade arXiv Research desde el menú de herramientas.

OpenAI actualmente requiere un endpoint HTTPS público (o su Secure MCP Tunnel) y Streamable HTTP, normalmente en /mcp. La disponibilidad del modo de desarrollador depende de la política de la cuenta y del espacio de trabajo. La página actual de OpenAI no lo promete para todos los planes concretos de ChatGPT, por lo que la presencia del interruptor de modo de desarrollador en tu cuenta es la verificación definitiva. Si una cuenta Plus no lo muestra, el servidor sigue siendo utilizable a través de MCP Inspector, otro cliente MCP o el OpenAI API Playground. Consulta la guía de conexión actual de OpenAI y la guía de servidores MCP.

Ejemplos de prompts para ChatGPT

  • Search arXiv for recent quantum gravity papers.

  • Find papers about the Bondi-Sachs formalism.

  • Search hep-th for path integral approaches to gravity.

  • Find papers by Roger Penrose related to general relativity.

  • Get the metadata and PDF link for arXiv:2401.12345.

Estructura del proyecto

.
├── src/arxiv_mcp/
│   ├── arxiv_client.py
│   ├── config.py
│   ├── models.py
│   └── server.py
├── tests/
├── .github/workflows/ci.yml
├── .env.example
├── Dockerfile
├── render.yaml
├── pyproject.toml
└── README.md

Con licencia MIT.

Available Tools

5 tools
get_arxiv_paperGet an arXiv paperA
Read-onlyIdempotent

Retrieve complete metadata for one known arXiv ID, including abstract, DOI, journal reference, categories, and PDF link.

Inputs: arxiv_id (required). Returns: Normalized metadata for one arXiv paper.

get_recent_arxiv_papersGet recent arXiv papersA
Read-onlyIdempotent

Return the most recently submitted papers in one arXiv category. Use for current literature scans and research updates.

Inputs: category (required), max_results. Returns: A page of arXiv search results.

search_arxivSearch arXivA
Read-onlyIdempotent

Search the official arXiv index by keywords or advanced arXiv query syntax. Use this for general paper discovery and pagination.

Inputs: query (required), start, sort_by, sort_order, +1 more. Returns: A page of arXiv search results.

search_arxiv_by_authorSearch arXiv by authorB
Read-onlyIdempotent

Find arXiv papers written by a named author. Use this when the author is the main search constraint.

Inputs: author_name (required), max_results. Returns: A page of arXiv search results.

search_arxiv_by_categorySearch an arXiv categoryB
Read-onlyIdempotent

Search within one arXiv subject category, optionally narrowed by keywords. Use for fields such as gr-qc, hep-th, quant-ph, math-ph, or astro-ph.CO.

Inputs: category (required), keywords, max_results. Returns: A page of arXiv search results.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: general search, specific paper retrieval, author search, category search, and recent papers. No two tools overlap in function; the specialized search tools are properly scoped with explicit use cases, and get_recent_arxiv_papers is differentiated from search_arxiv_by_category by focusing on recency rather than keyword filtering.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern, with 'search_' for discovery operations and 'get_' for retrieval. The pattern is uniform despite minor semantic differences (e.g., 'search_arxiv' vs 'search_arxiv_by_author' vs 'get_recent_arxiv_papers'), and the naming makes the action and target obvious.

    Tool Count5/5

    Five tools is an ideal scope for an arXiv research client. Each tool provides a distinct capability that covers the primary use cases of paper discovery and metadata retrieval without unnecessary bloat. The count feels intentional and well-balanced for the server's stated purpose.

    Completeness4/5

    The tool surface covers the core arXiv workflows: general search, targeted searches by author and category, retrieval by ID, and recent-paper scans. The only minor gaps are non-essential features like citation lookup or category listing, but these are not critical for the server's purpose and can be worked around with existing tools (e.g., using search_arxiv for category keywords).

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides search functionality for arXiv.org papers through the official arXiv API, allowing users to search papers by keywords, filter by subject categories and date ranges, and receive comprehensive metadata including PDF links.
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      Enables searching and retrieving academic papers from arXiv by various criteria including title, author, and category, with support for extracting full text content from PDFs.
      4
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI assistants to search arXiv papers, retrieve metadata, browse categories, and read paper text.
      5
      MIT