Markovo-CLI- und MCP-Server

Markovo wandelt unterstützte Dateien und ausdrücklich autorisierte öffentliche HTTPS-Seiten in sauberes, strukturiertes Markdown um. Für das Web-Erlebnis und Produktdetails besuchen Sie den PDF-zu-Markdown-Konverter.

Dieses öffentliche Repository ist die Vertriebsquelle für den kundenseitigen markovo-CLI und den markovo-mcp-stdio-MCP-Server. Es enthält keine lokale Konvertierungs-Engine, keinen Backend-Dienst, keine Bereitstellungskonfiguration, keine Anmeldeinformationen und keine Abrechnungsimplementierung. Die Konvertierung erfolgt über den abgerechneten Dienst unter https://markovo.net.

Installation

pip install markovo

Oder führen Sie es ohne dauerhafte Installation aus:

uvx markovo --help
uvx --from markovo markovo-mcp

Related MCP server: MarkItDown MCP Server

API-Schlüssel und Credits

1. Erstellen Sie einen API-Schlüssel im Entwicklerportal.

2. Speichern Sie ihn in Ihrer Shell oder im Secret-Store des MCP-Hosts; fügen Sie ihn nicht in Prompts ein und committen Sie ihn nicht in die Versionskontrolle.

3. Überprüfen Sie die Einrichtung:

export MARKOVO_API_KEY="your-key"
markovo doctor --json

Jede Konvertierung erfordert ein explizites Credit-Kontingent. Wenn ein Schlüssel fehlt, verweist der Client auf das Entwicklerportal. Wenn die Credits nicht ausreichen, verweist die Dienstantwort auf die Abrechnungsseite, damit das Konto aufgeladen werden kann, bevor es erneut versucht wird.

MCP-Konfiguration

{
  "mcpServers": {
    "markovo": {
      "command": "uvx",
      "args": ["--from", "markovo", "markovo-mcp"],
      "env": {
        "MARKOVO_API_KEY": "${MARKOVO_API_KEY}",
        "MARKOVO_MCP_ROOT": "/path/to/safe/project"
      }
    }
  }
}

MCP-Clients sollten MARKOVO_API_KEY über ihre Secret- oder Umgebungsvariablen-Einstellungen injizieren. Der Schlüssel und die Dienst-URL sind niemals MCP-Argumente, sodass Prompts die Anmeldeinformationen nicht umleiten können. Der öffentliche Client akzeptiert nur https://markovo.net und folgt keinen authentifizierten Weiterleitungen.

Der MCP-Server kann nur innerhalb des erforderlichen MARKOVO_MCP_ROOT lesen und schreiben. Setzen Sie ihn auf das kleinste dedizierte Projektverzeichnis, das Ihr MCP-Host benötigt. Wenn es fehlt, verweigert der Server alle Dateiwerkzeuge; Elternverzeichnis- und Symlink-Ausbrüche werden abgelehnt.

export MARKOVO_MCP_ROOT="/path/to/safe/project"

Strukturierte Fehler verweisen auf das Entwicklerportal, wenn ein Schlüssel fehlt, und auf die Abrechnung, wenn die Credits nicht ausreichen.

Links

• Markovo-Startseite

• PDF zu Markdown

• Dokumentation

• Preise und Credits

• Entwicklerportal und API-Schlüssel

• Abrechnung und Aufladen

Sicherheit

Melden Sie Sicherheitsprobleme privat über die Anweisungen in SECURITY.md. Fügen Sie keine API-Schlüssel, Kundendokumente oder private Konvertierungsergebnisse in ein öffentliches Issue ein.