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
{
"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"]
}
}
}
Où placer chaque configuration :
| Client | Emplacement |
|---|---|
| Claude Code | la commande ci-dessus ; ajoutez --scope user pour le rendre disponible dans tous les projets |
| Claude Desktop | Settings → 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.
| Argument | Type | Par défaut | Rôle |
|---|---|---|---|
text | string | obligatoire | Texte à encoder. |
url_safe | boolean | false | Alphabet URL-safe (- et _). |
padding | boolean | true | Ajoute le remplissage =. |
wrap | integer | 0 | Saut 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.
| Argument | Type | Rôle |
|---|---|---|
data | string | Texte 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é.
| Champ | Signification |
|---|---|
valid | true exactement quand base64_decode réussirait. |
variant | standard, url, mixed ou either. |
padded | La longueur, = compris, est un multiple de 4. |
bytes | Taille décodée en octets. |
error | Pourquoi 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