Datei hochladen
  1. base64hub
  2. Doku
  3. MCP-Server

Referenz zum MCP-Server

base64hub-mcp ist ein lokaler stdio-MCP-Server mit drei Tools, die nur lesen. Ihr Client startet ihn mit npx; er braucht Node.js 18 oder neuer und keinen API-Schlüssel.

Client einrichten

Jeder Client startet den Server mit dem Befehl npx und den Argumenten -y base64hub-mcp.

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

Wohin die jeweilige Konfiguration gehört:

ClientOrt
Claude Codeder Befehl oben; mit --scope user steht der Server in jedem Projekt zur Verfügung
Claude DesktopSettings → Developer → Edit Config öffnet claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\); starten Sie Claude danach neu
Cursor~/.cursor/mcp.json für alle Projekte, .cursor/mcp.json für ein einzelnes
VS Code.vscode/mcp.json im Workspace, mit einem Objekt servers auf oberster Ebene

VS Code kann den Server auch aus einem Terminal hinzufügen:

code --add-mcp '{"name":"base64hub","type":"stdio","command":"npx","args":["-y","base64hub-mcp"]}'

Findet ein Client unter Windows npx nicht, verwenden Sie den Befehl cmd mit den Argumenten /c npx -y base64hub-mcp. Jeder andere Client, der stdio-Server startet, funktioniert mit demselben Befehl und denselben Argumenten.

Tools

Alle drei Tools lesen nur und funktionieren offline.

base64_encode

Kodiert Text als UTF-8 in Base64.

ArgumentTypStandardBedeutung
textstringerforderlichDer zu kodierende Text.
url_safebooleanfalseURL-sicheres Alphabet (- und _).
paddingbooleantrue=-Padding anhängen.
wrapinteger0Zeilenumbruch nach je N Zeichen; 76 ist MIME.

{"text": "Hello, hub!"} liefert SGVsbG8sIGh1YiE=. {"text": "Привет", "url_safe": true, "padding": false} liefert 0J_RgNC40LLQtdGC.

base64_decode

Dekodiert Base64 in Text. Beide Alphabete, fehlendes Padding, Leerraum und URIs der Form data:...;base64, werden akzeptiert.

ArgumentTypBedeutung
datastringBase64-Text oder eine Data-URI.

{"data": "SGVsbG8sIGh1YiE"} liefert Hello, hub!. Sind die Bytes kein gültiges UTF-8, sagt das Ergebnis das und gibt sie als Hex aus; für +/+/:

The data decodes to 3 bytes that are not valid UTF-8 text. Hex:
fbffbf

Ungültige Eingaben ergeben einen Tool-Fehler mit dem Grund, zum Beispiel Invalid Base64: invalid character '!' at position 4.

base64_validate

Prüft einen String, ohne ihn zu dekodieren. Das Ergebnis ist JSON und wird zusätzlich als strukturierter Inhalt (Structured Content) gesendet.

FeldBedeutung
validtrue genau dann, wenn base64_decode gelingen würde.
variantstandard, url, mixed oder either.
paddedDie Länge einschließlich = ist ein Vielfaches von 4.
bytesDekodierte Größe in Bytes.
errorWarum die Eingabe ungültig ist; nur wenn valid gleich false ist.

{"data": "-_-_"} liefert {"valid":true,"variant":"url","padded":true,"bytes":3}.

Protokoll

JSON-RPC 2.0 über stdio, eine Nachricht pro Zeile, ohne SDK geschrieben. Logs gehen ausschließlich auf die Standardfehlerausgabe und vermischen sich so nie mit Protokollnachrichten. Ein Tool-Aufruf sieht auf der Leitung so aus:

{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"base64_encode","arguments":{"text":"Hello, hub!"}}}
{"jsonrpc":"2.0","id":3,"result":{"content":[{"type":"text","text":"SGVsbG8sIGh1YiE="}]}}

Der Server ist auf npm als base64hub-mcp und in der MCP Registry als com.base64hub/mcp veröffentlicht.

Aktualisiert 22.11.2026