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:
| Tool | Argumente | Ergebnis |
|---|---|---|
base64_encode | text, optional url_safe, padding, wrap | der kodierte Text |
base64_decode | data | UTF-8-Text, oder Hex mit Hinweis, wenn die Bytes kein Text sind |
base64_validate | data | JSON 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.