Por qué un asistente necesita una herramienta Base64
Un modelo escribe Base64 token a token, prediciendo lo que suele venir después. Las cadenas cortas y habituales a menudo salen bien; las largas, el texto que no es ASCII y las variantes URL-safe son donde se equivoca, y un solo carácter incorrecto cambia los bytes. Una llamada a una herramienta pasa el trabajo a código que sigue el RFC 4648 al pie de la letra, y el asistente recibe un resultado que puede citar.
base64hub-mcp ofrece tres herramientas:
| Herramienta | Argumentos | Resultado |
|---|---|---|
base64_encode | text y, opcionalmente, url_safe, padding, wrap | el texto codificado |
base64_decode | data | texto UTF-8, o hex con una nota cuando los bytes no son texto |
base64_validate | data | JSON con valid, variant, padded, bytes, error |
La decodificación es tan tolerante como en el resto de base64hub: los espacios, un prefijo data:, la falta de relleno y cualquiera de los dos alfabetos no son problema. Eso ayuda a los asistentes, que a menudo reciben Base64 copiado de logs, JWT o JSON.
Añádelo a tu cliente
El servidor es un paquete de npm que se arranca con npx, así que el único requisito es Node.js. En Claude Code basta un comando:
claude mcp add base64hub -- npx -y base64hub-mcp
Claude Desktop y Cursor leen un archivo JSON con un bloque mcpServers:
{
"mcpServers": {
"base64hub": {
"command": "npx",
"args": ["-y", "base64hub-mcp"]
}
}
}
VS Code usa servers en .vscode/mcp.json. La ubicación de los archivos de cada cliente está en la documentación del servidor MCP.
Cómo funciona
El servidor habla JSON-RPC 2.0 por stdio: el cliente lo arranca como proceso hijo e intercambia mensajes por stdin y stdout. Está escrito a mano, sin SDK y sin dependencias, así que npx descarga un único paquete pequeño. No escucha en ningún puerto de red. Su nombre en el MCP Registry es com.base64hub/mcp.
Cuando el modelo pide base64_encode con {"text": "Hello, hub!"}, la herramienta devuelve SGVsbG8sIGh1YiE=. Con {"text": "Привет", "url_safe": true, "padding": false} devuelve 0J_RgNC40LLQtdGC.
Sin MCP
Si tu asistente puede ejecutar código, también puede llamar al módulo base64 de Python o a b64 desde una shell; la CLI y el paquete de Python dan los mismos resultados que este servidor. Si solo necesitas comprobar algo rápido tú mismo, pega la cadena en el decodificador Base64 de tu navegador.
Preguntas frecuentes
¿Qué es un servidor MCP de Base64?
Un pequeño programa que habla el Model Context Protocol y ofrece herramientas Base64 a un asistente de IA. Cuando el asistente necesita codificar o decodificar, llama a la herramienta y recibe una respuesta exacta en lugar de predecir los caracteres.
¿base64hub-mcp envía mis datos a algún sitio?
No. Se ejecuta como un proceso local que arranca tu cliente MCP y se comunica con él por stdin y stdout. Lo único que se descarga es el propio paquete de npm, la primera vez que npx lo ejecuta.
¿Qué clientes de IA pueden usarlo?
Cualquier cliente que ejecute servidores MCP por stdio. La documentación del servidor MCP tiene configuraciones listas para Claude Desktop, Claude Code, Cursor y VS Code.
¿Qué pasa cuando los datos decodificados no son texto?
base64_decode devuelve los bytes en hex con una nota que avisa de que no son UTF-8, para que el asistente no muestre caracteres ilegibles como si fueran texto.