Enviar um arquivo
  1. base64hub
  2. Docs
  3. Servidor MCP

Referência do servidor MCP

O base64hub-mcp é um servidor MCP local via stdio com três ferramentas somente leitura. O seu cliente o inicia com npx; ele precisa do Node.js 18 ou mais novo e de nenhuma chave de API.

Configuração do cliente

Todo cliente inicia o servidor com o comando npx e os argumentos -y base64hub-mcp.

claude mcp add base64hub -- npx -y base64hub-mcp

Onde fica cada configuração:

ClienteLocal
Claude Codeo comando acima; acrescente --scope user para deixá-lo disponível em todos os projetos
Claude DesktopSettings → Developer → Edit Config abre o claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\); reinicie o Claude depois
Cursor~/.cursor/mcp.json para todos os projetos, .cursor/mcp.json para um só
VS Code.vscode/mcp.json no workspace, com um objeto servers no nível de cima

O VS Code também consegue adicioná-lo pelo terminal:

code --add-mcp '{"name":"base64hub","type":"stdio","command":"npx","args":["-y","base64hub-mcp"]}'

No Windows, se um cliente não encontrar o npx, use o comando cmd com os argumentos /c npx -y base64hub-mcp. Qualquer outro cliente que inicie servidores via stdio funciona com o mesmo comando e os mesmos argumentos.

Ferramentas

As três ferramentas são somente leitura e funcionam offline.

base64_encode

Codifica texto, como UTF-8, em Base64.

ArgumentoTipoPadrãoSignificado
textstringobrigatórioTexto a codificar.
url_safebooleanfalseAlfabeto URL-safe (- e _).
paddingbooleantrueAcrescenta o preenchimento =.
wrapinteger0Quebra de linha a cada N caracteres; 76 é MIME.

{"text": "Hello, hub!"} retorna SGVsbG8sIGh1YiE=. {"text": "Привет", "url_safe": true, "padding": false} retorna 0J_RgNC40LLQtdGC.

base64_decode

Decodifica Base64 para texto. Os dois alfabetos, preenchimento ausente, espaços em branco e URIs data:...;base64, são aceitos.

ArgumentoTipoSignificado
datastringTexto Base64 ou uma data URI.

{"data": "SGVsbG8sIGh1YiE"} retorna Hello, hub!. Quando os bytes não são UTF-8 válido, o resultado avisa e os mostra em hex; para +/+/:

The data decodes to 3 bytes that are not valid UTF-8 text. Hex:
fbffbf

Uma entrada inválida retorna um erro de ferramenta com o motivo, por exemplo Invalid Base64: invalid character '!' at position 4.

base64_validate

Confere uma string sem decodificá-la. O resultado é JSON, enviado também como conteúdo estruturado.

CampoSignificado
validtrue exatamente quando o base64_decode daria certo.
variantstandard, url, mixed ou either.
paddedO tamanho, = incluído, é múltiplo de 4.
bytesTamanho decodificado em bytes.
errorPor que a entrada é inválida; só quando valid é false.

{"data": "-_-_"} retorna {"valid":true,"variant":"url","padded":true,"bytes":3}.

Protocolo

JSON-RPC 2.0 via stdio, uma mensagem por linha, escrito sem SDK. Os logs vão só para a saída de erro padrão, então nunca se misturam com as mensagens do protocolo. Uma chamada de ferramenta fica assim no fio:

{"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="}]}}

O servidor está publicado no npm como base64hub-mcp e no MCP Registry como com.base64hub/mcp.

Atualizado 22 de nov. de 2026