Übersicht
Der Web2MD MCP-Server stellt Web2MD als eine Reihe von Tools bereit, die AI-Assistenten direkt aufrufen können, unter Verwendung des Model Context Protocol (MCP) — einem offenen Standard zur Verbindung von AI-Modellen mit externen Tools und Datenquellen. Nach der Konfiguration können Sie Claude, Cursor oder Windsurf bitten, Seiten zu konvertieren, Ihren Konvertierungsverlauf zu durchsuchen oder gespeicherte Markdown-Inhalte abzurufen, ohne die Konversation zu verlassen.Der MCP-Server erfordert einen Web2MD API-Schlüssel (PRO-Plan). Erstellen Sie einen im Dashboard.
Verfügbare Tools
Der MCP-Server stellt drei Tools bereit:convert_url
Ruft eine URL ab und liefert den Seiteninhalt als Markdown zurück. Unterstützt dieselben Konvertierungsoptionen wie die REST API. Beispiel-Prompt: “Convert this URL to markdown: https://docs.example.com/getting-started”semantic_search
Durchsucht alle Ihre zuvor gespeicherten Konvertierungen mithilfe einer Anfrage in natürlicher Sprache. Liefert eine Liste passender Konvertierungen mit Titeln, URLs und Relevanz-Scores. Beispiel-Prompt: “Search my saved pages for articles about database indexing”get_conversion
Ruft den vollständigen Markdown-Inhalt einer bestimmten gespeicherten Konvertierung anhand ihrer ID ab. Nützlich, um ein vollständiges Dokument in den Kontext zu holen, nachdem es mitsemantic_search gefunden wurde.
Beispiel-Prompt: “Get the full content of conversion abc123”
Einrichtung
- Claude Desktop
- Cursor
- Windsurf
Öffnen Sie Ihre Claude Desktop-Konfigurationsdatei:Starten Sie Claude Desktop neu. Die Web2MD-Tools sollten nun im Tool-Picker erscheinen.
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
web2md-Eintrag unter mcpServers hinzu:Anwendungsbeispiele
Sobald der MCP-Server läuft, können Sie natürliche Sprache in Ihrem AI-Assistenten verwenden:Eine Seite in Markdown konvertieren
Eine Seite in Markdown konvertieren
Sie: Convert this URL to markdown: https://react.dev/learn/thinking-in-reactAssistent: (ruft
convert_url auf) Hier ist das konvertierte Markdown für “Thinking in React”…Gespeicherte Konvertierungen durchsuchen
Gespeicherte Konvertierungen durchsuchen
Sie: Search my saved pages for anything about authenticationAssistent: (ruft
semantic_search auf) Ich habe 3 gespeicherte Konvertierungen zum Thema Authentifizierung gefunden:- “OAuth 2.0 Guide” — vor 2 Tagen gespeichert
- “JWT Best Practices” — letzte Woche gespeichert
- …
Eine vollständige Konvertierung abrufen
Eine vollständige Konvertierung abrufen
Sie: Get the full content of conversion abc123Assistent: (ruft
get_conversion auf) Hier ist der vollständige Markdown-Inhalt…Fehlerbehebung
Tools erscheinen nach der Einrichtung nicht
Tools erscheinen nach der Einrichtung nicht
Stellen Sie sicher, dass Sie die Anwendung nach dem Bearbeiten der Konfigurationsdatei neu gestartet haben. Überprüfen Sie, ob
npx web2md-mcp in Ihrem Terminal erfolgreich ausgeführt wird.Authentifizierungsfehler
Authentifizierungsfehler
Überprüfen Sie, ob Ihr
WEB2MD_API_KEY korrekt ist und Ihr PRO-Abonnement aktiv ist. Sie können Ihren Schlüssel auf der API-Schlüssel-Seite überprüfen.npx kann das Paket nicht auflösen
npx kann das Paket nicht auflösen
Versuchen Sie zunächst, das Paket global zu installieren:
npm install -g web2md-mcp, ändern Sie dann den command in web2md-mcp und entfernen Sie das args-Feld.