上传文件
  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

把文本按 UTF-8 编码为 Base64。

参数类型默认值含义
textstring必填要编码的文本。
url_safebooleanfalseURL 安全字母表(- 和 _)。
paddingbooleantrue添加 = 填充。
wrapinteger0每 N 个字符后换行;76 对应 MIME。

{"text": "Hello, hub!"} 返回 SGVsbG8sIGh1YiE=。{"text": "Привет", "url_safe": true, "padding": false} 返回 0J_RgNC40LLQtdGC。

base64_decode

把 Base64 解码为文本。两种字母表、缺失的填充、空白和 data:...;base64, URI 都接受。

参数类型含义
datastringBase64 文本或 data URI。

{"data": "SGVsbG8sIGh1YiE"} 返回 Hello, hub!。字节不是有效的 UTF-8 时,结果会说明这一点,并以十六进制给出字节;对于 +/+/,结果是:

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,同时也作为结构化内容发送。

字段含义
valid恰好在 base64_decode 能成功时为 true。
variantstandard、url、mixed 或 either。
padded包括 = 在内的长度是 4 的倍数。
bytes解码后的字节数。
error输入无效的原因;仅在 valid 为 false 时出现。

{"data": "-_-_"} 返回 {"valid":true,"variant":"url","padded":true,"bytes":3}。

协议

通过 stdio 使用 JSON-RPC 2.0,每行一条消息,没有借助 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="}]}}

服务器以 base64hub-mcp 的名称发布在 npm 上,在 MCP Registry 中的名称是 com.base64hub/mcp。

更新于 2026年11月22日