Referencia del servidor MCP
base64hub-mcp es un servidor MCP local por stdio con tres herramientas de solo lectura. Tu cliente lo arranca con npx; necesita Node.js 18 o posterior y ninguna clave de API.
Configuración del cliente
Todos los clientes arrancan el servidor con el comando npx y los argumentos -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"]
}
}
}
Dónde va cada configuración:
| Cliente | Ubicación |
|---|---|
| Claude Code | el comando de arriba; añade --scope user para tenerlo disponible en todos los proyectos |
| Claude Desktop | Settings → Developer → Edit Config abre claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\); reinicia Claude después |
| Cursor | ~/.cursor/mcp.json para todos los proyectos, .cursor/mcp.json para uno solo |
| VS Code | .vscode/mcp.json en el espacio de trabajo, con un objeto servers en el nivel superior |
VS Code también puede añadirlo desde una terminal:
code --add-mcp '{"name":"base64hub","type":"stdio","command":"npx","args":["-y","base64hub-mcp"]}'
En Windows, si un cliente no encuentra npx, usa el comando cmd con los argumentos /c npx -y base64hub-mcp. Cualquier otro cliente que arranque servidores por stdio funciona con el mismo comando y los mismos argumentos.
Herramientas
Las tres herramientas son de solo lectura y funcionan sin conexión.
base64_encode
Codifica texto, como UTF-8, a Base64.
| Argumento | Tipo | Por defecto | Significado |
|---|---|---|---|
text | string | obligatorio | Texto que se codifica. |
url_safe | boolean | false | Alfabeto URL-safe (- y _). |
padding | boolean | true | Añade el relleno =. |
wrap | integer | 0 | Salto de línea cada N caracteres; 76 es MIME. |
{"text": "Hello, hub!"} devuelve SGVsbG8sIGh1YiE=. {"text": "Привет", "url_safe": true, "padding": false} devuelve 0J_RgNC40LLQtdGC.
base64_decode
Decodifica Base64 a texto. Acepta los dos alfabetos, la falta de relleno, espacios en blanco y URI data:...;base64,.
| Argumento | Tipo | Significado |
|---|---|---|
data | string | Texto Base64 o un data URI. |
{"data": "SGVsbG8sIGh1YiE"} devuelve Hello, hub!. Cuando los bytes no son UTF-8 válido, el resultado lo indica y los da en hex; para +/+/:
The data decodes to 3 bytes that are not valid UTF-8 text. Hex:
fbffbf
Una entrada no válida devuelve un error de herramienta con el motivo, por ejemplo Invalid Base64: invalid character '!' at position 4.
base64_validate
Comprueba una cadena sin decodificarla. El resultado es JSON y también se envía como contenido estructurado.
| Campo | Significado |
|---|---|
valid | true exactamente cuando base64_decode tendría éxito. |
variant | standard, url, mixed o either. |
padded | La longitud, = incluidos, es múltiplo de 4. |
bytes | Tamaño decodificado en bytes. |
error | Por qué la entrada no es válida; solo cuando valid es false. |
{"data": "-_-_"} devuelve {"valid":true,"variant":"url","padded":true,"bytes":3}.
Protocolo
JSON-RPC 2.0 por stdio, un mensaje por línea, escrito sin SDK. Los logs van solo a la salida de error estándar, así que nunca se mezclan con los mensajes del protocolo. Así se ve una llamada a una herramienta en el canal:
{"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="}]}}
El servidor está publicado en npm como base64hub-mcp y en el MCP Registry como com.base64hub/mcp.
Actualizado 22 nov 2026