ARES MCP

Servidor local Model Context Protocol para búsqueda y redacción de literatura académica. Se comunica con catálogos abiertos (OpenAlex, arXiv, Crossref), descarga PDFs de acceso abierto (solo archivos PDF), extrae secciones IMRaD bajo demanda y añade BibTeX, diseñado para ejecutarse junto a Cursor.

Licencia: MIT. Contribuciones: CONTRIBUTING.md.

ARES no elude los muros de pago de los editores. Si no existe un PDF de OA, las herramientas devuelven no_open_pdf en lugar de extraer HTML.

Este repositorio es un asistente de literatura, no un banco de trabajo de cribado/auditoría PRISMA.

Tools

Flujo típico del agente: buscar (sort=cited_by para artículos famosos) → descargar un resultado de OA → extraer Resumen/Métodos → get_bibtex.

Related MCP server: Scholar MCP Server

Requisitos

• Python 3.11+

• uv recomendado para uvx

Un archivo .env no es necesario. ARES elige un correo de contacto para el grupo de cortesía de OpenAlex / Unpaywall en este orden:

1. ares-mcp --mailto you@university.edu

2. ARES_MAILTO en el entorno del proceso (bloque env de mcp.json de Cursor)

3. .env opcional en el directorio de trabajo (ARES_MAILTO=...) — solo para clonados locales

4. git config user.email

5. Marcador de posición ares-mcp@localhost (el servidor aún se inicia)

Instalar desde PyPI (Cursor)

Después de publicar:

{
  "mcpServers": {
    "ares": {
      "command": "uvx",
      "args": ["ares-mcp"]
    }
  }
}

Identidad opcional (aún sin .env):

{
  "mcpServers": {
    "ares": {
      "command": "uvx",
      "args": ["ares-mcp", "--mailto", "you@university.edu"]
    }
  }
}

Instalar (desarrollo)

git clone <this-repo>
cd AREsMCP
uv sync

Ejecutar pruebas:

uv run pytest
uv run ruff check src tests

Comprobaciones de API en vivo (opcional):

uv run pytest -m integration

Configurar Cursor (clon local)

Copia .cursor/mcp.json y reemplaza la ruta --project con tu clon. El correo es opcional; se usa user.email de git si no se establece.

Recomendado — uv run:

{
  "mcpServers": {
    "ares": {
      "command": "uv",
      "args": [
        "run",
        "--project",
        "C:/Users/vitor/Documents/Projetos/AREsMCP",
        "ares-mcp"
      ]
    }
  }
}

venv Python:

{
  "mcpServers": {
    "ares": {
      "command": "C:/Users/vitor/Documents/Projetos/AREsMCP/.venv/Scripts/python.exe",
      "args": ["-m", "ares_mcp.server"]
    }
  }
}

uvx desde un clon local (no se requiere publicación en PyPI):

{
  "mcpServers": {
    "ares": {
      "command": "uvx",
      "args": ["--from", "C:/Users/vitor/Documents/Projetos/AREsMCP", "ares-mcp"]
    }
  }
}

Recarga los servidores MCP en Cursor y luego pregunta: «Busca artículos de acceso abierto sobre redes neuronales de grafos desde 2022».

Inspector (fuera de Cursor):

uv run fastmcp dev src/ares_mcp/server.py

Entorno

Las escrituras están restringidas al directorio de trabajo actual del servidor (el proyecto que abrió Cursor). Se rechaza el recorrido de rutas.

Notas de API

• OpenAlex: GET /works con search + filter. Los resúmenes se almacenan como índices invertidos y se reconstruyen localmente. La descarga usa todas las locations con pdf_url, además de los ids de arXiv/PMC cuando estén presentes.

• Unpaywall: GET /v2/{doi} para copias legales de OA (preprints, manuscritos aceptados, repositorios). Así es como muchos artículos de IEEE/Elsevier se vuelven descargables sin tocar el HTML del muro de pago.

• arXiv: API Atom en export.arxiv.org. Todos los resultados son de OA.

• Crossref: negociación de contenido DOI Accept: application/x-bibtex.

• Identifica tu proceso con --mailto o ARES_MAILTO cuando puedas. No golpees las APIs; cada llamada de herramienta es un puñado de solicitudes con un reintento en 429/5xx.

Si cada candidato de OA devuelve 403 o HTML, la herramienta informa download_failed o no_open_pdf. Pasa un id de arXiv cuando sepas que existe un preprint. ARES no extraerá el HTML del editor.

Licencia alternativa

MIT es la licencia del proyecto. Apache-2.0 puede considerarse más adelante si se requiere una concesión de patente; discútelo en un issue antes de relicenciar.

Estado

MVP 0.1.0. Publica con uv build y uv publish (o Trusted Publisher en GitHub Actions). Después, Cursor puede ejecutar uvx ares-mcp sin .env.