arXiv Research MCP

Ein schreibgeschützter, bereitstellbarer MCP-Server für die Recherche wissenschaftlicher Literatur.

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

Der Server ruft Metadaten ab und normalisiert sie. ChatGPT bleibt verantwortlich für die Erklärung von Physik, den Vergleich von Papieren und das Durcharbeiten von Gleichungen.

Werkzeuge

Jedes Werkzeug ist als schreibgeschützt markiert und gibt typisierte strukturierte Daten zurück, die die arXiv-ID, den normalisierten Titel und die Zusammenfassung, Autoren, Kategorien, Daten, DOI, Journal-Referenz, Abstract-URL und PDF-URL (sofern verfügbar) enthalten.

Lokale Einrichtung

Erfordert Python 3.11 oder neuer.

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

Bearbeiten Sie ARXIV_USER_AGENT in .env und ersetzen Sie den Beispielkontakt durch Ihre E-Mail-Adresse oder Projekt-URL. arXiv erfordert keinen API-Schlüssel.

Lokal über stdio ausführen:

arxiv-mcp

Führen Sie den remote-kompatiblen Transport lokal aus:

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

Die Endpunkte sind:

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

Für einen manuellen Werkzeugtest starten Sie den HTTP-Server, führen Sie den offiziellen MCP Inspector aus und verbinden Sie ihn mit http://127.0.0.1:8000/mcp:

npx @modelcontextprotocol/inspector@latest

Tests ausführen

pytest
ruff check .

Tests verwenden simulierte HTTP-Antworten und verbrauchen nicht die arXiv-API. GitHub Actions führt dieselben Prüfungen bei jedem Push und Pull Request aus.

Zuverlässigkeit und Sicherheit

• Fester, auf die Whitelist gesetzter Ursprung: https://export.arxiv.org/api/query

• Standardmäßig drei Sekunden Abstand zwischen globalen Anfragen

• Begrenzte Wiederholungsversuche bei Zeitüberschreitungen, Netzwerkfehlern, HTTP 429 und vorübergehenden 5xx-Antworten

• Strenge Validierung von Ergebnis, Offset, Kategorie, Sortierung und arXiv-ID

• Sicheres XML-Parsing mit deaktivierten externen Entitäten

• Keine Shell-Ausführung, kein Abrufen beliebiger URLs, keine Geheimnisse, keine Schreiboperationen und keine Speicherung von Benutzerdaten

• Zustandslose Streamable-HTTP-Bereitstellung

Auf Render bereitstellen

Das Repository enthält ein nicht-Root-Dockerfile und ein render.yaml-Blueprint.

1. Schieben Sie dieses Repository auf GitHub.

2. Melden Sie sich bei Render an und wählen Sie Neu → Blueprint.

3. Verbinden Sie das GitHub-Repository und wenden Sie render.yaml an.

4. Ändern Sie in der Render-Service-Umgebung ARXIV_USER_AGENT, um Ihre echte Kontakt-E-Mail oder Repository-URL einzuschließen.

5. Warten Sie, bis /health erfolgreich ist, und kopieren Sie dann die Service-URL.

Die endgültige MCP-URL lautet:

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

Das Blueprint verwendet die kostenlose Instanz von Render, sodass die Bereitstellung keine stillschweigende Zahlungsverpflichtung erzeugt. Render dokumentiert, dass kostenlose Dienste nach 15 Minuten Inaktivität schlafen und etwa eine Minute zum Neustart benötigen. Dieser Kaltstart kann das Timeout eines MCP-Clients überschreiten. Aktualisieren Sie den Dienst auf starter oder eine andere kostenpflichtige Instanz, bevor Sie sich auf ihn als ständig verfügbaren Produktionskonnektor verlassen. Siehe Render Free-Tier-Einschränkungen und Blueprint-Referenz.

Mit ChatGPT verbinden

Diese Schritte folgen der aktuellen offiziellen OpenAI-Dokumentation:

1. Stellen Sie den Server bereit und bestätigen Sie, dass die öffentliche HTTPS-/mcp-URL im MCP Inspector funktioniert.

2. Öffnen Sie in ChatGPT Einstellungen → Sicherheit und Anmeldung und aktivieren Sie den Entwicklermodus.

3. Öffnen Sie ChatGPT-Plugins und wählen Sie die Plus-Schaltfläche.

4. Geben Sie ein:

   • Name: arXiv Research

   • Beschreibung: Read-only search and metadata retrieval from the official arXiv API.

   • Verbindung: öffentlicher MCP-Endpunkt

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

   • Authentifizierung: keine

5. Erstellen Sie die Verbindung und bestätigen Sie, dass genau fünf Werkzeuge erkannt werden.

6. Starten Sie einen neuen Chat und fügen Sie arXiv Research aus dem Werkzeugmenü hinzu.

OpenAI erfordert derzeit einen öffentlichen HTTPS-Endpunkt (oder seinen Secure MCP Tunnel) und Streamable HTTP, typischerweise unter /mcp. Die Verfügbarkeit des Entwicklermodus hängt von der Konto- und Workspace-Richtlinie ab. Die aktuelle Seite von OpenAI verspricht ihn nicht für jeden benannten ChatGPT-Plan, daher ist das Vorhandensein des Entwicklermodus-Umschalters auf Ihrem Konto die maßgebliche Prüfung. Wenn ein Plus-Konto ihn nicht anzeigt, bleibt der Server über MCP Inspector, einen anderen MCP-Client oder den OpenAI API Playground nutzbar. Siehe OpenAIs aktuellen Verbindungsleitfaden und MCP-Server-Leitfaden.

Beispiel-ChatGPT-Aufforderungen

• 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.

Projektstruktur

.
├── 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

MIT-lizenziert.