Suppr MCP - Benutzerhandbuch | MCP-Dienst für Dokumentenübersetzung und chinesische PubMed-Suche | Suppr Super Literature

Suppr MCP Server

Suppr (Super Literature) ist eine KI-gestützte Plattform für akademische Werkzeuge von WildData. Dieser MCP-Server stellt KI-Assistenten Funktionen zur Dokumentenübersetzung und Literatursuche zur Verfügung.

🌐 KI-Dokumentenübersetzung — Übersetzen Sie PDF-, Word- (.docx), Excel- (.xlsx), PowerPoint- (.pptx), TXT- und HTML-Dokumente in 13 Sprachen. Behält die ursprüngliche Formatierung bei. Automatische Erkennung der Ausgangssprache.

🔬 PubMed Akademische Suche — Semantische Literaturrecherche in Millionen von biomedizinischen Forschungsarbeiten. Liefert strukturierte Metadaten: DOI, PMID, Journal Impact Factor, Zitationszahlen, Autorenzugehörigkeiten, Abstracts und direkte Links zu den Arbeiten.

🤖 MCP-kompatibel — Funktioniert mit Claude Desktop, Cursor, Windsurf und jedem Model Context Protocol-Client.

Installation

npx suppr-mcp

Schnellstart

1. Installation

Globale Installation:

npm install -g suppr-mcp

Oder verwenden Sie npx (keine Installation erforderlich):

npx suppr-mcp

2. API-Schlüssel abrufen

Besuchen Sie Suppr API, um Ihren API-Schlüssel zu erhalten.

3. Umgebungsvariablen konfigurieren

export SUPPR_API_KEY=your_api_key_here

4. Verwendung im MCP-Client

Claude Desktop Konfiguration

Bearbeiten Sie ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) oder die entsprechende Konfigurationsdatei:

{
  "mcpServers": {
    "suppr": {
      "command": "npx",
      "args": ["-y", "suppr-mcp"],
      "env": {
        "SUPPR_API_KEY": "your_api_key_here"
      }
    }
  }
}

Oder verwenden Sie die globale Installation:

{
  "mcpServers": {
    "suppr": {
      "command": "suppr-mcp",
      "env": {
        "SUPPR_API_KEY": "your_api_key_here"
      }
    }
  }
}

Verfügbare Werkzeuge

1. create_translation - Übersetzungsaufgabe erstellen

Erstellt eine Dokumentenübersetzungsaufgabe.

Parameter:

• file_path (Wählen Sie entweder file_path oder file_url): Pfad zur Quelldatei

• file_url (Wählen Sie entweder file_path oder file_url): URL des zu übersetzenden Dokuments

• to_lang (erforderlich): Zielsprachcode

• from_lang (optional): Ausgangssprachcode (Standard: automatische Erkennung)

• optimize_math_formula (optional): Mathematische Formeln optimieren (nur PDF)

Beispiel:

{
  "file_url": "https://example.com/document.pdf",
  "to_lang": "en",
  "from_lang": "zh",
  "optimize_math_formula": true
}

Rückgabe:

{
  "task_id": "02a6c6d1-3f70-4a5a-80bc-971d53a37bb1",
  "status": "INIT",
  "consumed_point": 453,
  "source_lang": "zh",
  "target_lang": "en",
  "optimize_math_formula": true
}

2. get_translation - Übersetzungsdetails abrufen

Ruft detaillierte Informationen und den Status einer Übersetzungsaufgabe ab.

Parameter:

• task_id (erforderlich): ID der Übersetzungsaufgabe

Beispiel:

{
  "task_id": "02a6c6d1-3f70-4a5a-80bc-971d53a37bb1"
}

Rückgabe:

{
  "task_id": "02a6c6d1-3f70-4a5a-80bc-971d53a37bb1",
  "status": "DONE",
  "progress": 1.0,
  "consumed_point": 453,
  "source_file_name": "document.pdf",
  "source_file_url": "https://example.com/source.pdf",
  "target_file_url": "https://example.com/translated.pdf",
  "source_lang": "zh",
  "target_lang": "en",
  "error_msg": null,
  "optimize_math_formula": true
}

Statusbeschreibung der Aufgabe:

• INIT: Initialisierung

• PROGRESS: In Bearbeitung

• DONE: Abgeschlossen

• ERROR: Fehler

3. list_translations - Übersetzungsaufgaben auflisten

Ruft eine Liste der Übersetzungsaufgaben ab, unterstützt Paginierung.

Parameter:

• offset (optional): Paginierungs-Offset, Standard 0

• limit (optional): Anzahl pro Seite, Standard 20

Beispiel:

{
  "offset": 0,
  "limit": 10
}

Rückgabe:

{
  "total": 42,
  "offset": 0,
  "limit": 10,
  "list": [
    {
      "task_id": "...",
      "status": "DONE",
      "progress": 1.0,
      ...
    }
  ]
}

4. search_documents - Literatursuche

KI-gestützte semantische Literatursuche.

Parameter:

• query (erforderlich): Suchanfrage in natürlicher Sprache

• topk (optional): Maximale Anzahl der Ergebnisse (1-100, Standard 20)

• return_doc_keys (optional): Spezifizierte Rückgabefelder

• auto_select (optional): Automatische Auswahl der besten Ergebnisse (Standard: true)

Beispiel:

{
  "query": "糖尿病最新研究进展",
  "topk": 5,
  "return_doc_keys": ["title", "abstract", "doi", "authors"],
  "auto_select": true
}

Verfügbare Rückgabefelder:

• title: Titel

• abstract: Zusammenfassung

• authors: Autorenliste

• doi: DOI

• pmid: PubMed ID

• link: Link

• publication: Publikation

• pub_year: Erscheinungsjahr

• Weitere Felder finden Sie in der API-Dokumentation

Rückgabe:

{
  "search_items": [
    {
      "doc": {
        "title": "...",
        "abstract": "...",
        "authors": [...],
        "doi": "...",
        ...
      },
      "search_gateway": "pubmed"
    }
  ],
  "consumed_points": 20
}

Unterstützte Sprachen

Gebräuchliche Sprachcodes:

• en: Englisch

• zh: Chinesisch

• ko: Koreanisch

• ja: Japanisch

• fr: Französisch

• de: Deutsch

• es: Spanisch

• ru: Russisch

• ar: Arabisch

• pt: Portugiesisch

• it: Italienisch

• auto: Automatische Erkennung

Fehlerbehandlung

Alle Fehler werden in einem Standardformat zurückgegeben:

{
  "code": 非零错误码,
  "msg": "错误信息",
  "data": null
}

Häufige Fehler:

• 401: API-Schlüssel ungültig oder nicht angegeben

• 400: Fehlerhafte Anfrageparameter

• 404: Ressource nicht gefunden

Anwendungsbeispiele

Verwendung in Claude Desktop

1. Starten Sie Claude Desktop nach der Konfiguration des API-Schlüssels neu.

2. Verwenden Sie die Werkzeuge im Chat:

Dokument übersetzen:

Bitte übersetze dieses Dokument: https://example.com/paper.pdf, ins Englische

Literatur suchen:

Suche nach aktueller Literatur zum Thema "Anwendung von Deep Learning in der medizinischen Bildgebung"

Übersetzungsstatus abfragen:

Zeige den Fortschritt der Übersetzung für Aufgabe 02a6c6d1-3f70-4a5a-80bc-971d53a37bb1

Häufig gestellte Fragen (FAQ)

F: Wie erhalte ich einen API-Schlüssel?

A: Besuchen Sie https://suppr.wilddata.cn/api-keys, um sich zu registrieren und einen API-Schlüssel zu erhalten.

F: Welche Dokumentformate werden unterstützt?

A: Unterstützt werden PDF, DOCX, PPTX, XLSX, HTML, TXT, EPUB und andere gängige Formate.

F: Wie lange dauert die Übersetzung?

A: Dies hängt von der Größe des Dokuments ab und dauert in der Regel einige Minuten bis zu einer Viertelstunde. Sie können den Fortschritt mit get_translation abfragen.

F: Wie lade ich das übersetzte Dokument herunter?

A: Nach Abschluss der Übersetzung gibt get_translation eine target_file_url zurück. Besuchen Sie diesen Link direkt, um den Download zu starten.

F: npx-Ausführung fehlgeschlagen?

A: Stellen Sie sicher, dass die Node.js-Version >= 18.0.0 ist und die Umgebungsvariable SUPPR_API_KEY gesetzt wurde.

🔗 Suppr Super Literature Produkte

• Zotero-Plugin : https://github.com/WildDataX/suppr-zotero-plugin

• Offizielle Website: https://suppr.wilddata.cn

• KI-Dokumentenübersetzung: https://suppr.wilddata.cn/translate/upload

• API-Dienst: https://openapi.suppr.wilddata.cn/introduction

• Chinesische PubMed-Suche: https://suppr.wilddata.cn/

• Deep Research: https://suppr.wilddata.cn/deep-research

• GitHub-Organisation: WildDataX

Technischer Support

Für Hilfe kontaktieren Sie bitte: IT@wilddata.cn

Made with ❤️ by WildData

Suppr Ökosystem