Pourquoi un assistant a besoin d’un outil Base64
Un modèle écrit le Base64 un token à la fois, en prédisant ce qui vient d’habitude ensuite. Les chaînes courtes et courantes sortent souvent justes ; c’est sur les chaînes longues, le texte non ASCII et les variantes URL-safe qu’il dérape, et un seul caractère faux change les octets. Un appel d’outil confie le travail à du code qui suit exactement la RFC 4648, et l’assistant récupère un résultat qu’il peut citer.
base64hub-mcp propose trois outils :
| Outil | Arguments | Résultat |
|---|---|---|
base64_encode | text, et en option url_safe, padding, wrap | le texte encodé |
base64_decode | data | du texte UTF-8, ou de l’hexadécimal avec une note quand les octets ne sont pas du texte |
base64_validate | data | du JSON avec valid, variant, padded, bytes, error |
Le décodage est aussi tolérant que dans le reste de base64hub : espaces, préfixe data:, remplissage manquant et les deux alphabets passent sans problème. C’est utile aux assistants, qui reçoivent souvent du Base64 copié depuis des journaux, des JWT ou du JSON.
L’ajouter à votre client
Le serveur est un paquet npm lancé avec npx : Node.js est le seul prérequis. Dans Claude Code, une seule commande suffit :
claude mcp add base64hub -- npx -y base64hub-mcp
Claude Desktop et Cursor lisent un fichier JSON avec un bloc mcpServers :
{
"mcpServers": {
"base64hub": {
"command": "npx",
"args": ["-y", "base64hub-mcp"]
}
}
}
VS Code utilise servers dans .vscode/mcp.json. L’emplacement des fichiers pour chaque client est indiqué dans la documentation MCP.
Comment ça marche
Le serveur parle JSON-RPC 2.0 sur stdio : le client le démarre comme processus enfant et échange des messages par l’entrée et la sortie standard. Il est écrit à la main, sans SDK, et n’a aucune dépendance : npx ne récupère donc qu’un petit paquet. Rien n’écoute sur un port réseau. Son nom dans le MCP Registry est com.base64hub/mcp.
Quand le modèle demande base64_encode avec {"text": "Hello, hub!"}, l’outil renvoie SGVsbG8sIGh1YiE=. Avec {"text": "Привет", "url_safe": true, "padding": false}, il renvoie 0J_RgNC40LLQtdGC.
Sans MCP
Si votre assistant peut exécuter du code, il peut aussi appeler le module base64 de Python ou b64 depuis un shell ; la CLI et le paquet Python donnent les mêmes résultats que ce serveur. Si vous voulez simplement vérifier quelque chose vous-même, collez la chaîne dans le décodeur Base64 de votre navigateur.
FAQ
Qu'est-ce qu'un serveur MCP Base64 ?
Un petit programme qui parle le Model Context Protocol et met des outils Base64 à la disposition d’un assistant IA. Quand l’assistant doit encoder ou décoder, il appelle l’outil et obtient une réponse exacte au lieu de prédire les caractères.
base64hub-mcp envoie-t-il mes données quelque part ?
Non. Il tourne comme un processus local lancé par votre client MCP et communique avec lui par l’entrée et la sortie standard. Le seul téléchargement est celui du paquet npm lui-même, la première fois que npx le lance.
Quels clients IA peuvent l'utiliser ?
Tout client qui lance des serveurs MCP en stdio. La documentation MCP fournit des configurations prêtes pour Claude Desktop, Claude Code, Cursor et VS Code.
Que se passe-t-il quand les données décodées ne sont pas du texte ?
base64_decode renvoie les octets en hexadécimal avec une note indiquant qu’ils ne sont pas en UTF-8 : l’assistant n’affiche pas de caractères illisibles comme s’il s’agissait de texte.