Por que um assistente precisa de uma ferramenta Base64
Um modelo escreve Base64 um token por vez, prevendo o que costuma vir em seguida. Strings curtas e comuns muitas vezes saem certas; strings longas, texto fora do ASCII e variantes URL-safe são onde ele escorrega, e um único caractere errado muda os bytes. Uma chamada de ferramenta passa o trabalho para um código que segue a RFC 4648 à risca, e o assistente recebe um resultado que pode citar.
O base64hub-mcp oferece três ferramentas:
| Ferramenta | Argumentos | Resultado |
|---|---|---|
base64_encode | text, e opcionalmente url_safe, padding, wrap | o texto codificado |
base64_decode | data | texto UTF-8, ou hex com um aviso quando os bytes não são texto |
base64_validate | data | JSON com valid, variant, padded, bytes, error |
A decodificação é tão tolerante quanto no resto do base64hub: espaços em branco, um prefixo data:, preenchimento ausente e qualquer um dos dois alfabetos são aceitos. Isso ajuda os assistentes, que muitas vezes recebem Base64 copiado de logs, JWTs ou JSON.
Adicione ao seu cliente
O servidor é um pacote npm iniciado com npx, então o único requisito é o Node.js. No Claude Code, basta um comando:
claude mcp add base64hub -- npx -y base64hub-mcp
O Claude Desktop e o Cursor leem um arquivo JSON com um bloco mcpServers:
{
"mcpServers": {
"base64hub": {
"command": "npx",
"args": ["-y", "base64hub-mcp"]
}
}
}
O VS Code usa servers em .vscode/mcp.json. A localização dos arquivos de cada cliente está na documentação do MCP.
Como funciona
O servidor fala JSON-RPC 2.0 via stdio: o cliente o inicia como processo filho e troca mensagens pela stdin e pela stdout. Ele foi escrito à mão, sem SDK, e não tem dependências, então o npx baixa um único pacote pequeno. Nada fica escutando em porta de rede. O nome dele no MCP Registry é com.base64hub/mcp.
Quando o modelo pede base64_encode com {"text": "Hello, hub!"}, a ferramenta devolve SGVsbG8sIGh1YiE=. Com {"text": "Привет", "url_safe": true, "padding": false}, ela devolve 0J_RgNC40LLQtdGC.
Sem MCP
Se o seu assistente consegue executar código, ele também pode chamar o módulo base64 do Python ou o b64 num shell; a CLI e o pacote Python dão os mesmos resultados que este servidor. Se você só precisa conferir algo rapidamente, cole a string no decodificador Base64 do seu navegador.
Perguntas frequentes
O que é um servidor MCP de Base64?
Um pequeno programa que fala o Model Context Protocol e oferece ferramentas Base64 a um assistente de IA. Quando o assistente precisa codificar ou decodificar, ele chama a ferramenta e recebe uma resposta exata, em vez de prever os caracteres.
O base64hub-mcp envia meus dados para algum lugar?
Não. Ele roda como um processo local iniciado pelo seu cliente MCP e conversa com ele pela stdin e pela stdout. O único download é o próprio pacote npm, na primeira vez que o npx o executa.
Quais clientes de IA podem usá-lo?
Qualquer cliente que execute servidores MCP via stdio. A documentação do MCP traz configurações prontas para Claude Desktop, Claude Code, Cursor e VS Code.
O que acontece quando os dados decodificados não são texto?
O base64_decode devolve os bytes em hex com um aviso de que não são UTF-8, para que o assistente não mostre caracteres embaralhados como se fossem texto.