Зачем ассистенту инструмент для Base64
Модель пишет Base64 по одному токену, предсказывая, что обычно идёт дальше. Короткие распространённые строки часто получаются правильно, а на длинных строках, тексте за пределами ASCII и URL-safe вариантах она ошибается, и один неверный символ меняет байты. Вызов инструмента передаёт работу коду, который точно следует RFC 4648, и ассистент получает результат, который можно привести дословно.
base64hub-mcp предлагает три инструмента:
| Инструмент | Аргументы | Результат |
|---|---|---|
base64_encode | text, необязательные url_safe, padding, wrap | закодированный текст |
base64_decode | data | текст UTF-8 или hex с пометкой, если байты не текст |
base64_validate | data | JSON с полями valid, variant, padded, bytes, error |
Декодирование здесь такое же нестрогое, как и во всём base64hub: пробелы, префикс data:, строка без дополнения и любой из алфавитов допустимы. Это помогает ассистентам, которым Base64 часто достаётся скопированным из логов, JWT или JSON.
Подключение к клиенту
Сервер – это пакет npm, который запускается через npx, так что нужен только Node.js. В Claude Code это одна команда:
claude mcp add base64hub -- npx -y base64hub-mcp
Claude Desktop и Cursor читают JSON-файл с блоком mcpServers:
{
"mcpServers": {
"base64hub": {
"command": "npx",
"args": ["-y", "base64hub-mcp"]
}
}
}
VS Code использует servers в .vscode/mcp.json. Где лежат файлы конфигурации для каждого клиента, описано в документации MCP.
Как это работает
Сервер общается по JSON-RPC 2.0 через stdio: клиент запускает его как дочерний процесс и обменивается с ним сообщениями через stdin и stdout. Он написан вручную, без SDK, и зависимостей у него нет, поэтому npx скачивает один небольшой пакет. Сетевые порты он не слушает. В MCP Registry он зарегистрирован под именем com.base64hub/mcp.
Когда модель вызывает base64_encode с {"text": "Hello, hub!"}, инструмент возвращает SGVsbG8sIGh1YiE=. С {"text": "Привет", "url_safe": true, "padding": false} он возвращает 0J_RgNC40LLQtdGC.
Без MCP
Если ассистент умеет выполнять код, он может вызвать модуль base64 из Python или b64 из оболочки: CLI и пакет для Python дают те же результаты, что и этот сервер. Если вам самим нужно быстро что-то проверить, вставьте строку в декодер Base64 в браузере.
Вопросы и ответы
Что такое MCP-сервер для Base64?
Небольшая программа, которая работает по протоколу Model Context Protocol и предлагает ИИ-ассистенту инструменты Base64. Когда ассистенту нужно что-то закодировать или декодировать, он вызывает инструмент и получает точный ответ, а не предсказывает символы.
Отправляет ли base64hub-mcp куда-нибудь мои данные?
Нет. Это локальный процесс, который запускает ваш MCP-клиент, и общаются они через stdin и stdout. Из сети скачивается только сам пакет npm, при первом запуске через npx.
Какие ИИ-клиенты его поддерживают?
Любой клиент, который умеет запускать stdio MCP-серверы. В документации MCP есть готовые конфигурации для Claude Desktop, Claude Code, Cursor и VS Code.
Что будет, если декодированные данные не текст?
base64_decode возвращает байты в hex с пометкой, что это не UTF-8, чтобы ассистент не показывал искажённые символы под видом текста.