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
把文本按 UTF-8 编码为 Base64。
| 参数 | 类型 | 默认值 | 含义 |
|---|---|---|---|
text | string | 必填 | 要编码的文本。 |
url_safe | boolean | false | URL 安全字母表(- 和 _)。 |
padding | boolean | true | 添加 = 填充。 |
wrap | integer | 0 | 每 N 个字符后换行;76 对应 MIME。 |
{"text": "Hello, hub!"} 返回 SGVsbG8sIGh1YiE=。{"text": "Привет", "url_safe": true, "padding": false} 返回 0J_RgNC40LLQtdGC。
base64_decode
把 Base64 解码为文本。两种字母表、缺失的填充、空白和 data:...;base64, URI 都接受。
| 参数 | 类型 | 含义 |
|---|---|---|
data | string | Base64 文本或 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。 |
variant | standard、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日