Datei hochladen
  1. base64hub
  2. Download
  3. MCP-Server
v1.0.0 · Open Source · MIT

base64hub MCP-Server: Base64-Tools für KI-Assistenten

Sprachmodelle sagen Base64 Token für Token voraus, und bei langen oder Nicht-ASCII-Strings kommt oft etwas Falsches heraus. base64hub-mcp ist ein kleiner lokaler MCP-Server mit drei Tools, die für Claude, Cursor, VS Code und andere MCP-Clients exakte Ergebnisse berechnen.

npx -y base64hub-mcp
Kostenlos ohne Konto, ohne Schlüssel MIT Open-Source-Lizenz Null Laufzeitabhängigkeiten Aktualisiert 22.11.2026

Warum ein Assistent ein Base64-Tool braucht

Ein Modell schreibt Base64 Token für Token und sagt dabei vorher, was üblicherweise als Nächstes kommt. Kurze, häufige Strings gelingen oft; bei langen Strings, Nicht-ASCII-Text und URL-sicheren Varianten passieren Fehler, und ein einziges falsches Zeichen ändert die Bytes. Ein Tool-Aufruf verlagert die Arbeit in Code, der RFC 4648 genau folgt, und der Assistent bekommt ein Ergebnis zurück, das er zitieren kann.

base64hub-mcp bietet drei Tools:

ToolArgumenteErgebnis
base64_encodetext, optional url_safe, padding, wrapder kodierte Text
base64_decodedataUTF-8-Text, oder Hex mit Hinweis, wenn die Bytes kein Text sind
base64_validatedataJSON mit valid, variant, padded, bytes, error

Das Dekodieren ist so nachsichtig wie im Rest von base64hub: Leerraum, ein data:-Präfix, fehlendes Padding und beide Alphabete sind kein Problem. Das hilft Assistenten, denn sie bekommen Base64 oft aus Logs, JWTs oder JSON kopiert.

Zum Client hinzufügen

Der Server ist ein npm-Paket, das mit npx gestartet wird, Node.js ist also die einzige Voraussetzung. In Claude Code genügt ein Befehl:

claude mcp add base64hub -- npx -y base64hub-mcp

Claude Desktop und Cursor lesen eine JSON-Datei mit einem Block mcpServers:

{
  "mcpServers": {
    "base64hub": {
      "command": "npx",
      "args": ["-y", "base64hub-mcp"]
    }
  }
}

VS Code verwendet servers in .vscode/mcp.json. Die Dateipfade für jeden Client stehen in der MCP-Doku.

So funktioniert es

Der Server spricht JSON-RPC 2.0 über stdio: Der Client startet ihn als Kindprozess und tauscht Nachrichten über stdin und stdout aus. Er ist ohne SDK von Hand geschrieben und hat keine Abhängigkeiten, npx lädt also ein einziges kleines Paket. Nichts lauscht auf einem Netzwerkport. Sein Name in der MCP Registry ist com.base64hub/mcp.

Fordert das Modell base64_encode mit {"text": "Hello, hub!"} an, gibt das Tool SGVsbG8sIGh1YiE= zurück. Mit {"text": "Привет", "url_safe": true, "padding": false} gibt es 0J_RgNC40LLQtdGC zurück.

Ohne MCP

Kann Ihr Assistent Code ausführen, kann er auch das Python-Modul base64 oder b64 in einer Shell aufrufen; das CLI und das Python-Paket liefern dieselben Ergebnisse wie dieser Server. Wollen Sie selbst nur kurz etwas prüfen, fügen Sie den String in den Base64-Decoder in Ihrem Browser ein.

Häufige Fragen

Was ist ein Base64-MCP-Server?

Ein kleines Programm, das das Model Context Protocol spricht und einem KI-Assistenten Base64-Tools anbietet. Muss der Assistent kodieren oder dekodieren, ruft er das Tool auf und bekommt eine exakte Antwort, statt die Zeichen vorherzusagen.

Sendet base64hub-mcp meine Daten irgendwohin?

Nein. Der Server läuft als lokaler Prozess, den Ihr MCP-Client startet, und kommuniziert mit ihm über stdin und stdout. Der einzige Download ist das npm-Paket selbst, wenn npx es zum ersten Mal ausführt.

Welche KI-Clients können ihn nutzen?

Jeder Client, der stdio-MCP-Server ausführt. Die MCP-Doku enthält fertige Konfigurationen für Claude Desktop, Claude Code, Cursor und VS Code.

Was passiert, wenn die dekodierten Daten kein Text sind?

base64_decode gibt die Bytes als Hex zurück, mit dem Hinweis, dass sie kein UTF-8 sind. So gibt der Assistent keine verstümmelten Zeichen als Text aus.

Mehr von base64hub