上传文件
  1. base64hub
  2. 下载
  3. MCP 服务器
v1.0.0 · 开源 · MIT

base64hub MCP 服务器:为 AI 助手提供 Base64 工具

语言模型逐个 token 地预测 Base64,长字符串或非 ASCII 字符串经常出错。base64hub-mcp 是一个小型本地 MCP 服务器,提供三个工具,为 Claude、Cursor、VS Code 和其他 MCP 客户端计算出精确的结果。

npx -y base64hub-mcp
免费 无需账号,无需密钥 MIT 开源许可证 零 运行时依赖 更新于 2026年11月22日

为什么助手需要 Base64 工具

模型逐个 token 地写出 Base64,每一步都在预测接下来通常会出现什么。简短常见的字符串往往能写对;长字符串、非 ASCII 文本和 URL 安全变体则容易出错,而错一个字符,字节就变了。调用工具就把这项工作交给严格遵循 RFC 4648 的代码,助手拿回的是可以直接引用的结果。

base64hub-mcp 提供三个工具:

工具参数结果
base64_encodetext,可选 url_safe、padding、wrap编码后的文本
base64_decodedataUTF-8 文本;字节不是文本时,返回十六进制并附说明
base64_validatedata包含 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,这样助手就不会把乱码当成文本展示出来。

base64hub 的更多产品