Charger un fichier
  1. base64hub
  2. Docs
  3. Serveur MCP

Référence du serveur MCP

base64hub-mcp est un serveur MCP local en stdio avec trois outils en lecture seule. Votre client le lance avec npx ; il nécessite Node.js 18 ou ultérieur, et aucune clé d’API.

Configuration du client

Chaque client lance le serveur avec la commande npx et les arguments -y base64hub-mcp.

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

Où placer chaque configuration :

ClientEmplacement
Claude Codela commande ci-dessus ; ajoutez --scope user pour le rendre disponible dans tous les projets
Claude DesktopSettings → Developer → Edit Config ouvre claude_desktop_config.json (macOS : ~/Library/Application Support/Claude/, Windows : %APPDATA%\Claude\) ; redémarrez Claude ensuite
Cursor~/.cursor/mcp.json pour tous les projets, .cursor/mcp.json pour un seul
VS Code.vscode/mcp.json dans l’espace de travail, avec un objet servers au premier niveau

VS Code peut aussi l’ajouter depuis un terminal :

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

Sous Windows, si un client ne trouve pas npx, utilisez la commande cmd avec les arguments /c npx -y base64hub-mcp. Tout autre client capable de lancer des serveurs stdio fonctionne avec la même commande et les mêmes arguments.

Outils

Les trois outils sont en lecture seule et fonctionnent hors ligne.

base64_encode

Encode du texte, en UTF-8, en Base64.

ArgumentTypePar défautRôle
textstringobligatoireTexte à encoder.
url_safebooleanfalseAlphabet URL-safe (- et _).
paddingbooleantrueAjoute le remplissage =.
wrapinteger0Saut de ligne tous les N caractères ; 76 correspond à MIME.

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

base64_decode

Décode du Base64 en texte. Les deux alphabets, le remplissage manquant, les espaces et les URI data:...;base64, sont acceptés.

ArgumentTypeRôle
datastringTexte Base64 ou data URI.

{"data": "SGVsbG8sIGh1YiE"} renvoie Hello, hub!. Quand les octets ne sont pas de l’UTF-8 valide, le résultat le signale et les donne en hexadécimal ; pour +/+/ :

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

Une entrée invalide renvoie une erreur d’outil avec la raison, par exemple Invalid Base64: invalid character '!' at position 4.

base64_validate

Vérifie une chaîne sans la décoder. Le résultat est du JSON, envoyé aussi sous forme de contenu structuré.

ChampSignification
validtrue exactement quand base64_decode réussirait.
variantstandard, url, mixed ou either.
paddedLa longueur, = compris, est un multiple de 4.
bytesTaille décodée en octets.
errorPourquoi l’entrée est invalide ; seulement quand valid vaut false.

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

Protocole

JSON-RPC 2.0 sur stdio, un message par ligne, écrit sans SDK. Les journaux ne vont que sur la sortie d’erreur et ne se mélangent donc jamais aux messages du protocole. Voici à quoi ressemble un appel d’outil sur le fil :

{"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="}]}}

Le serveur est publié sur npm sous le nom base64hub-mcp et dans le MCP Registry sous com.base64hub/mcp.

Mis à jour 22 nov. 2026