Загрузить файл
  1. base64hub
  2. Скачать
  3. MCP-сервер
v1.0.0 · Открытый код · MIT

MCP-сервер base64hub: инструменты Base64 для ИИ-ассистентов

Языковые модели предсказывают Base64 токен за токеном, и длинные строки или строки не из ASCII часто выходят с ошибками. base64hub-mcp – небольшой локальный MCP-сервер с тремя инструментами, которые вычисляют точный результат для Claude, Cursor, VS Code и других MCP-клиентов.

npx -y base64hub-mcp
Бесплатно без аккаунта и ключа MIT открытая лицензия Ноль зависимостей во время выполнения Обновлено 22 нояб. 2026 г.

Зачем ассистенту инструмент для Base64

Модель пишет Base64 по одному токену, предсказывая, что обычно идёт дальше. Короткие распространённые строки часто получаются правильно, а на длинных строках, тексте за пределами ASCII и URL-safe вариантах она ошибается, и один неверный символ меняет байты. Вызов инструмента передаёт работу коду, который точно следует RFC 4648, и ассистент получает результат, который можно привести дословно.

base64hub-mcp предлагает три инструмента:

ИнструментАргументыРезультат
base64_encodetext, необязательные url_safe, padding, wrapзакодированный текст
base64_decodedataтекст UTF-8 или hex с пометкой, если байты не текст
base64_validatedataJSON с полями 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, чтобы ассистент не показывал искажённые символы под видом текста.

Ещё от base64hub