mcp-refchecker

Ein MCP-Server, mit dem Claude akademische Zitate in Echtzeit gegen Semantic Scholar, OpenAlex und Crossref überprüfen kann – um halluzinierte oder inkorrekte Referenzen zu finden, bevor sie in Ihrer Arbeit landen.

Basiert auf academic-refchecker (MIT).

Tool

verify_citation — überprüft, ob ein zitiertes Paper existiert und ob dessen Metadaten (Titel, Autoren, Jahr, Veranstaltungsort) mit dem Zitat übereinstimmen.

Gibt JSON zurück:

{
  "verified": true,
  "url": "https://...",
  "matched_paper": {
    "title": "...",
    "authors": [...],
    "year": 2023,
    "venue": "..."
  },
  "possible_match": null,
  "errors": null,
  "warnings": null,
  "info": null
}

Ergebnisfelder

• verified — true, wenn das Paper gefunden wurde und alle bereitgestellten Metadaten (Jahr, Autoren, Veranstaltungsort) übereinstimmen. false, wenn ein tatsächlicher Metadatenkonflikt vorliegt oder das Paper nicht gefunden werden konnte.

• matched_paper — die maßgeblichen Metadaten aus der Verifizierungsquelle.

• possible_match — ein Crossref-Fallback-Treffer, wenn der exakte Titel nicht gefunden wurde, aber eine ähnliche Variante existiert (siehe "Fuzzy-Fallback" unten).

• errors — schwerwiegende Fehler, die die Verifizierung blockieren (falsches Jahr, falsche Autoren, Paper nicht gefunden).

• warnings — leichte Warnungen, die die Verifizierung nicht blockieren (arXiv v1 vs. v2 Unterschiede, arXiv-Preprint vs. veröffentlichter Veranstaltungsort, unvollständige Eingabe-Metadaten).

• info — informative Vorschläge (z. B. "Referenz könnte arXiv-URL enthalten").

Was zählt als Fehler vs. Warnung

academic-refchecker gibt eine flache Liste von Problemen mit gewissen Inkonsistenzen zurück (Jahresabweichungen werden als Warnungen markiert, während Autorenabweichungen als Fehler markiert werden). Dieser Wrapper normalisiert die Ausgabe:

• Hochgestuft zu schwerwiegenden Fehlern: einfache year/author/venue-Abweichungen, bei denen die zitierten Metadaten tatsächlich von der Realität abweichen. Diese blockieren verified.

• Heruntergestuft zu Warnungen: "fehlendes Feld"-Fehler, wenn das Paper gefunden wurde, der Benutzer das Feld jedoch gar nicht erst angegeben hat. Fehlende Eingabe-Metadaten sind kein Beweis für ein halluziniertes Zitat.

• Beibehalten als Warnungen: arXiv-Versionsunterschiede (v1 vs. v2), Hinweise zu Preprint- vs. veröffentlichtem Veranstaltungsort.

Fuzzy-Fallback und seine Grenzen

Wenn academic-refchecker meldet, dass ein Paper nicht verifiziert werden konnte, führt dieser Wrapper eine sekundäre Abfrage bei Crossref unter Verwendung von Fuzzy-Titelabgleich und fuzzywuzzy.ratio durch. Wenn ein Kandidat mit ≥ 85 % Ähnlichkeit gefunden wird, wird dieser als possible_match mit einer Warnung zurückgegeben.

Was der Fuzzy-Fallback erkennt:

• Stilistische Titelvariationen (Groß-/Kleinschreibung, Interpunktion, Wortreihenfolge)

• Geringfügige Umformulierungen

• Titel, bei denen der strikte Vergleich von refchecker einen ansonsten gültigen Treffer abgelehnt hat

Was der Fuzzy-Fallback NICHT erkennt:

• Echte Tippfehler in markanten Titelwörtern (z. B. "Atention Is All You Need")

• Stark verstümmelte Titel

Dies ist eine grundlegende Einschränkung kostenloser akademischer Such-APIs. Crossref, OpenAlex und Semantic Scholar verwenden alle eine schlüsselwort-/tokenbasierte Suche – sobald ein markantes Wort falsch geschrieben ist, befindet es sich einfach nicht im Suchindex, und das echte Paper erscheint nicht in den Ergebnissen, unabhängig davon, wie Sie diese nachbearbeiten. Das Erkennen echter Tippfehler würde semantische Einbettungen von einer kostenpflichtigen API (OpenAI, Voyage usw.) oder eine Volltext-Fuzzy-Suchmaschine erfordern, von denen keine durch kostenlose wissenschaftliche Datenquellen bereitgestellt wird.

Wenn Sie einen Tippfehler vermuten, verify_citation aber "nicht verifiziert" zurückgibt, ist die beste Lösung, den Titel in der kanonischsten Form, die Sie finden können, neu zu schreiben und es erneut zu versuchen.

Related MCP server: Lyra's Expanded Research MCP

Installation & Konfiguration

Empfohlen: uvx (kein Installationsschritt)

Wenn Sie uv installiert haben, ist keine separate Installation erforderlich. Fügen Sie dies direkt zu Ihrer claude_desktop_config.json hinzu:

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

uvx lädt das Paket automatisch herunter und führt es in einer isolierten Umgebung aus. Starten Sie Claude Desktop nach dem Speichern der Konfiguration neu.

Alternative: pip

pip install mcp-refchecker

Fügen Sie dann dies zu claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "refchecker": {
      "command": "mcp-refchecker"
    }
  }
}

Aus dem Quellcode

git clone https://github.com/JonasBaath/mcp-refchecker
cd mcp-refchecker
pip install .

Optionale Umgebungsvariablen

• SEMANTIC_SCHOLAR_API_KEY — beantragen Sie hier einen für höhere Ratenlimits auf dem primären Verifizierungspfad von refchecker.

• CROSSREF_MAILTO — Ihre Kontakt-E-Mail-Adresse, die verwendet wird, um dem polite pool von Crossref beizutreten, für einen zuverlässigeren Zugriff auf den Fuzzy-Fallback.

• MCP_REFCHECKER_DEBUG — auf einen beliebigen nicht leeren Wert setzen, um Debug-Protokolle vom Fuzzy-Fallback-Pfad nach stderr zu drucken.

Beispiel mit allen optionalen Einstellungen (uvx):

{
  "mcpServers": {
    "refchecker": {
      "command": "uvx",
      "args": ["mcp-refchecker"],
      "env": {
        "SEMANTIC_SCHOLAR_API_KEY": "your-key-here",
        "CROSSREF_MAILTO": "you@example.com"
      }
    }
  }
}

Lizenz

MIT — © Jonas Bååth. Basiert auf academic-refchecker (MIT).