Enviar um arquivo
  1. base64hub
  2. Downloads
  3. Servidor MCP
v1.0.0 · Código aberto · MIT

Servidor MCP base64hub: Base64 para assistentes de IA

Modelos de linguagem preveem o Base64 token por token, e strings longas ou fora do ASCII muitas vezes saem erradas. O base64hub-mcp é um pequeno servidor MCP local com três ferramentas que calculam resultados exatos para o Claude, o Cursor, o VS Code e outros clientes MCP.

npx -y base64hub-mcp
Grátis sem conta, sem chave MIT licença de código aberto Zero dependências em tempo de execução Atualizado 22 de nov. de 2026

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:

FerramentaArgumentosResultado
base64_encodetext, e opcionalmente url_safe, padding, wrapo texto codificado
base64_decodedatatexto UTF-8, ou hex com um aviso quando os bytes não são texto
base64_validatedataJSON 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.

Mais do base64hub