Загрузить файл
  1. base64hub
  2. Документация
  3. MCP-сервер

Справочник по MCP-серверу

base64hub-mcp – локальный stdio MCP-сервер с тремя инструментами, которые только читают данные. Клиент запускает его через npx; нужен Node.js 18 или новее, API-ключ не нужен.

Настройка клиента

Каждый клиент запускает сервер командой npx с аргументами -y base64hub-mcp.

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

Куда помещается конфигурация:

КлиентГде
Claude Codeкоманда выше; добавьте --scope user, чтобы сервер был доступен во всех проектах
Claude DesktopSettings → Developer → Edit Config открывает claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\); после правки перезапустите Claude
Cursor~/.cursor/mcp.json для всех проектов, .cursor/mcp.json для одного
VS Code.vscode/mcp.json в рабочей области, с объектом servers на верхнем уровне

VS Code может добавить сервер и из терминала:

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

Если в Windows клиент не находит npx, укажите команду cmd с аргументами /c npx -y base64hub-mcp. Любой другой клиент, который запускает stdio-серверы, работает с той же командой и аргументами.

Инструменты

Все три инструмента только читают данные и работают офлайн.

base64_encode

Кодирует текст в Base64 как UTF-8.

АргументТипПо умолчаниюЗначение
textstringобязательныйТекст для кодирования.
url_safebooleanfalseURL-safe алфавит (- и _).
paddingbooleantrueДобавлять дополнение =.
wrapinteger0Перевод строки после каждых N символов; 76 – MIME.

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

base64_decode

Декодирует Base64 в текст. Принимает оба алфавита, строки без дополнения, пробельные символы и URI вида data:...;base64,.

АргументТипЗначение
datastringТекст Base64 или data URI.

{"data": "SGVsbG8sIGh1YiE"} возвращает Hello, hub!. Если байты не образуют корректный UTF-8, результат сообщает об этом и приводит их в hex; для +/+/ он такой:

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

На некорректных данных инструмент возвращает ошибку с причиной, например Invalid Base64: invalid character '!' at position 4.

base64_validate

Проверяет строку, не декодируя её. Результат – JSON, который также передаётся как структурированное содержимое (structured content).

ПолеЗначение
validtrue ровно тогда, когда base64_decode выполнился бы успешно.
variantstandard, url, mixed или either.
paddedДлина вместе с = кратна 4.
bytesРазмер после декодирования в байтах.
errorПочему данные некорректны; есть только когда valid равно false.

{"data": "-_-_"} возвращает {"valid":true,"variant":"url","padded":true,"bytes":3}.

Протокол

JSON-RPC 2.0 через stdio, одно сообщение на строку, без SDK. Логи идут только в стандартный поток ошибок, поэтому никогда не смешиваются с сообщениями протокола. Вызов инструмента в канале выглядит так:

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

Сервер опубликован в npm как base64hub-mcp и в MCP Registry как com.base64hub/mcp.

Обновлено 22 нояб. 2026 г.