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
{
"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"]
}
}
}
Onde fica cada configuração:
| Cliente | Local |
|---|---|
| Claude Code | o comando acima; acrescente --scope user para deixá-lo disponível em todos os projetos |
| Claude Desktop | Settings → 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.
| Argumento | Tipo | Padrão | Significado |
|---|---|---|---|
text | string | obrigatório | Texto a codificar. |
url_safe | boolean | false | Alfabeto URL-safe (- e _). |
padding | boolean | true | Acrescenta o preenchimento =. |
wrap | integer | 0 | Quebra 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.
| Argumento | Tipo | Significado |
|---|---|---|
data | string | Texto 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.
| Campo | Significado |
|---|---|
valid | true exatamente quando o base64_decode daria certo. |
variant | standard, url, mixed ou either. |
padded | O tamanho, = incluído, é múltiplo de 4. |
bytes | Tamanho decodificado em bytes. |
error | Por 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