- base64hub
- Документация
- MCP-сервер
Справочник по MCP-серверу
base64hub-mcp – локальный stdio MCP-сервер с тремя инструментами, которые только читают данные. Клиент запускает его через npx; нужен Node.js 18 или новее, API-ключ не нужен.
Настройка клиента
Каждый клиент запускает сервер командой npx с аргументами -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"]
}
}
}
Куда помещается конфигурация:
| Клиент | Где |
|---|---|
| Claude Code | команда выше; добавьте --scope user, чтобы сервер был доступен во всех проектах |
| Claude Desktop | Settings → 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.
| Аргумент | Тип | По умолчанию | Значение |
|---|---|---|---|
text | string | обязательный | Текст для кодирования. |
url_safe | boolean | false | URL-safe алфавит (- и _). |
padding | boolean | true | Добавлять дополнение =. |
wrap | integer | 0 | Перевод строки после каждых N символов; 76 – MIME. |
{"text": "Hello, hub!"} возвращает SGVsbG8sIGh1YiE=. {"text": "Привет", "url_safe": true, "padding": false} возвращает 0J_RgNC40LLQtdGC.
base64_decode
Декодирует Base64 в текст. Принимает оба алфавита, строки без дополнения, пробельные символы и URI вида data:...;base64,.
| Аргумент | Тип | Значение |
|---|---|---|
data | string | Текст 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).
| Поле | Значение |
|---|---|
valid | true ровно тогда, когда base64_decode выполнился бы успешно. |
variant | standard, 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 г.