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
{
"mcpServers": {
"base64hub": {
"command": "npx",
"args": ["-y", "base64hub-mcp"]
}
}
}
{
"mcpServers": {
"base64hub": {
"command": "npx",
"args": ["-y", "base64hub-mcp"]
}
}
}
{
"servers": {
"base64hub": {
"type": "stdio",
"command": "npx",
"args": ["-y", "base64hub-mcp"]
}
}
}
Wohin die jeweilige Konfiguration gehört:
| Client | Ort |
|---|---|
| Claude Code | der Befehl oben; mit --scope user steht der Server in jedem Projekt zur Verfügung |
| Claude Desktop | Settings → 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.
| Argument | Typ | Standard | Bedeutung |
|---|---|---|---|
text | string | erforderlich | Der zu kodierende Text. |
url_safe | boolean | false | URL-sicheres Alphabet (- und _). |
padding | boolean | true | =-Padding anhängen. |
wrap | integer | 0 | Zeilenumbruch 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.
| Argument | Typ | Bedeutung |
|---|---|---|
data | string | Base64-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.
| Feld | Bedeutung |
|---|---|
valid | true genau dann, wenn base64_decode gelingen würde. |
variant | standard, url, mixed oder either. |
padded | Die Länge einschließlich = ist ein Vielfaches von 4. |
bytes | Dekodierte Größe in Bytes. |
error | Warum 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