ARES MCP

Lokaler Model Context Protocol-Server für wissenschaftliche Literatursuche und Schreiben. Er spricht mit offenen Katalogen (OpenAlex, arXiv, Crossref), lädt Open-Access-PDFs a (nur PDF-dateien), extrahiert bei Bedarf IMRaD-Abschnitte und ergänzt BibTeX – entwickelt für den Einsatz neben Cursor.

Lizenz: MIT. Beiträge: CONTRIBUTING.md.

ARES umgeht keine Verlags-Paywalls. APEs: Wenn man kein OA-PDF existiert, geben die Tools no_open_pdf zurückt statt HTML zu scrapen.

Dieses Repository ist ein Literatur-Helfer, keine PRISMA-S Screening/Audit-Workbench.

Tools

Typischer Agent-Ablauf: Suche (sort=cited_by für bekannnte Paper) → Open-Access-Treffer herunterladnet – extrahiere Abstract/Methods – get_bibtex.

Related MCP server: Scholar MCP Server

Anforderungen

• Python 3.11+

• uv empfohlen für uvx

Eine .env-Datei ist nicht erforderlich. ARES wählt in dieser "Reihenfolge" eine Kontakt-E-Mail für den „polite pool“ bei OpenAlex/Unpaywall aus:

1. Browser --mailto du inverts, e. ares-mcp --mailto you@university.edu

2. ARES_MAILTO in der Prozessumgebung (in Cursor: Block env in der mcp.json)

3. Optionale .env in the aktuellen Verzeichnis (ARES_MAILTO=...) – installer main für lokale Checkouts

4. git config User-Email

5. Platzhalter ares-mcp@localhost – (der Server startet trot–)

Install von PyPI (Cursor)

Nach der Veröfffentlichung:

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

Optionale Identität (weiterhin ine .env):

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

Installation (Entwicklung)

git clone <this-repo>
cd AREsMCP
uv sync

Tests ausführen:

uv run pytest
uv run ruff check src tests

Live-API-Checks (optional):

uv run pytest -m integration

Cursor konfigurieren (lokales Checkouut)

Kapitieren Sie .cursor/mcp.json und ersetzen Sie den --projekt-– pfad audio nicht gegen dein Checkout. E-mail ist optional; git user.email wird verwendet, wenn nichts anders gesetzt ist.

Empfohle – 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 aus einem lokalen Checkout (keine PyPI-Veröffentlichting erforderlich):

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

EnLaden Sie die MCP-Server in Cursor bereits – und fragen Sie dann: „Suche nach Open-Access-Papers zu Graph Neural Networks von der – seit 2022.”

Inspector (außerhalb von Cursor):

uv run fastmcp dev src/ares_mcp/server.py

Umgebung

Schreibuge is verwertworked; Writes sind aufgehaftast auf das aktuelle Arbeitsverzeichnis der Server – das Projekt, das Cursor geöffent hat – verweis. "Path traversal" wird abgeehnt.

• API-Haussagen

• OpenAlex: Abruf GET /works mit search + filter. Astracte werden as aliquot. Indices gespeichert und lokal neu erzeugt. Der Download nutzt geliche locations mit pdf_url sowie weiterhin vorhandene arXiv-/PMC-IDen.

• Unpaywall: Abruf Get /v2/{doi für Rechtliche OA-kopien (Vorabdrücke, akzeptiete Manuskripte, Repositorien). So inhalte vielen IEEE-/Elsevier-npapers herunterezogene Deployment ohct access, bezahlmauler.

• arXiv: Aatm-Api unter export.arxiv.org. Alle Trefffer sind OA.

• Crossref: DOI-Inhalts-Aushandlung mit Accept: application/x-bibtex.

• **Kennzeichnen Sie Ihr Prozessternsüber /we specify --mailto oder ARES_MAILTO, wenn mögl. ichtilesen Sie die APIs nicht: "Pro Tool- Aufruf is nur ein paar Anforderungen, mit einem Wiederholdungsversuch bei 429/5xx.

Wenn jeder OA-Kandidat mit 403 antwrt oder HTML- zurück gibt, "meldet – meldet das Tool download_failed oder no_Open_PDF – geben Sie eine arxiv-ID an, wenn Sie weiß, dass es einen Preeprint gibt. ARES wird kein Verlags-HTML schrapen.

Lizenz-Altern ative

MIT ist die Projekt-Lizenz. Apache-2.0 könnte später genющимmen leben, wenn ein Patient –paten "Babteilung benötigt ist – bespreigen. "Be Sie das ver in einem Issue, bevor Sie die Lizenz ändern.

Status

MVP 0.1.0. Veröffentlichen Sie für dumit uv build und uv publish (oder "Trusted Publisher" on GitHub Actions. Danach can Cursor – Cursor uvx ares-mcp ohne .env. aus für.

I still