为什么助手需要 Base64 工具
模型逐个 token 地写出 Base64,每一步都在预测接下来通常会出现什么。简短常见的字符串往往能写对;长字符串、非 ASCII 文本和 URL 安全变体则容易出错,而错一个字符,字节就变了。调用工具就把这项工作交给严格遵循 RFC 4648 的代码,助手拿回的是可以直接引用的结果。
base64hub-mcp 提供三个工具:
| 工具 | 参数 | 结果 |
|---|---|---|
base64_encode | text,可选 url_safe、padding、wrap | 编码后的文本 |
base64_decode | data | UTF-8 文本;字节不是文本时,返回十六进制并附说明 |
base64_validate | data | 包含 valid、variant、padded、bytes、error 的 JSON |
解码和 base64hub 的其他产品一样宽容:空白、data: 前缀、缺失的填充和两种字母表都没问题。这对助手很有帮助,因为它们收到的 Base64 常常是从日志、JWT 或 JSON 里复制出来的。
添加到客户端
服务器是一个用 npx 启动的 npm 包,所以唯一的要求是 Node.js。在 Claude Code 中只需一条命令:
claude mcp add base64hub -- npx -y base64hub-mcp
Claude Desktop 和 Cursor 读取一个包含 mcpServers 块的 JSON 文件:
{
"mcpServers": {
"base64hub": {
"command": "npx",
"args": ["-y", "base64hub-mcp"]
}
}
}
VS Code 使用 .vscode/mcp.json 中的 servers。各客户端的配置文件位置见 MCP 文档。
工作原理
服务器通过 stdio 使用 JSON-RPC 2.0 通信:客户端把它作为子进程启动,通过 stdin 和 stdout 交换消息。它没有借助 SDK,完全手写,也没有任何依赖,所以 npx 只需获取一个小包。它不监听任何网络端口。它在 MCP Registry 中的名称是 com.base64hub/mcp。
当模型以 {"text": "Hello, hub!"} 调用 base64_encode 时,工具返回 SGVsbG8sIGh1YiE=。参数为 {"text": "Привет", "url_safe": true, "padding": false} 时,返回 0J_RgNC40LLQtdGC。
不用 MCP 的做法
如果你的助手能运行代码,它也可以调用 Python 的 base64 模块,或在 shell 中调用 b64;CLI 和 Python 包 给出的结果与这个服务器相同。如果你只是想自己快速检查一下,把字符串粘贴到浏览器中的 Base64 解码器 即可。
常见问题
什么是 Base64 MCP 服务器?
一个使用模型上下文协议(Model Context Protocol)通信、向 AI 助手提供 Base64 工具的小程序。助手需要编码或解码时,就调用这个工具,得到精确的答案,而不是去预测字符。
base64hub-mcp 会把我的数据发送到别处吗?
不会。它是由 MCP 客户端启动的本地进程,通过 stdin 和 stdout 与客户端通信。唯一的下载是 npx 首次运行它时获取的 npm 包本身。
哪些 AI 客户端可以使用它?
任何能运行 stdio MCP 服务器的客户端。MCP 文档 提供了 Claude Desktop、Claude Code、Cursor 和 VS Code 的现成配置。
解码出的数据不是文本时会怎样?
base64_decode 会以十六进制返回这些字节,并注明它们不是 UTF-8,这样助手就不会把乱码当成文本展示出来。