Subir un archivo
  1. base64hub
  2. Docs
  3. Servidor MCP

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

Dónde va cada configuración:

ClienteUbicación
Claude Codeel comando de arriba; añade --scope user para tenerlo disponible en todos los proyectos
Claude DesktopSettings → 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.

ArgumentoTipoPor defectoSignificado
textstringobligatorioTexto que se codifica.
url_safebooleanfalseAlfabeto URL-safe (- y _).
paddingbooleantrueAñade el relleno =.
wrapinteger0Salto 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,.

ArgumentoTipoSignificado
datastringTexto 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.

CampoSignificado
validtrue exactamente cuando base64_decode tendría éxito.
variantstandard, url, mixed o either.
paddedLa longitud, = incluidos, es múltiplo de 4.
bytesTamaño decodificado en bytes.
errorPor 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