アシスタントに Base64 ツールが必要な理由
モデルは Base64 を 1 トークンずつ、次に来そうなものを予測しながら書きます。短くてありふれた文字列なら正しく出てくることが多いのですが、長い文字列、ASCII 以外のテキスト、URLセーフの形式ではよく間違え、1 文字違うだけでバイト列が変わってしまいます。ツールを呼び出せば、その作業を RFC 4648 に厳密に従うコードに任せられ、アシスタントはそのまま引用できる結果を受け取れます。
base64hub-mcp が提供するツールは 3 つです。
| ツール | 引数 | 結果 |
|---|---|---|
base64_encode | text、省略可能な url_safe、padding、wrap | エンコードしたテキスト |
base64_decode | data | UTF-8 テキスト。バイト列がテキストでなければ注記付きの 16 進数 |
base64_validate | data | valid、variant、padded、bytes、error を持つ JSON |
デコードは base64hub の他の製品と同じく寛容で、空白、data: 接頭辞、パディングの欠落、どちらのアルファベットも問題ありません。アシスタントはログ、JWT、JSON からコピーされた Base64 を受け取ることが多いので、この寛容さが役に立ちます。
クライアントに追加する
サーバーは npx で起動する npm パッケージなので、必要なのは Node.js だけです。Claude Code ならコマンド 1 つです。
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 を話します。クライアントがサーバーを子プロセスとして起動し、標準入力と標準出力でメッセージをやり取りします。SDK を使わずに手書きしたもので依存関係がないため、npx が取得するのは小さなパッケージ 1 つだけです。ネットワークのポートで待ち受けることはありません。MCP Registry での名前は com.base64hub/mcp です。
モデルが {"text": "Hello, hub!"} で base64_encode を要求すると、ツールは SGVsbG8sIGh1YiE= を返します。{"text": "Привет", "url_safe": true, "padding": false} なら 0J_RgNC40LLQtdGC を返します。
MCP を使わない場合
アシスタントがコードを実行できるなら、Python の base64 モジュールや、シェルから b64 を呼ぶこともできます。CLI と Python パッケージ は、このサーバーと同じ結果を返します。自分でさっと確かめたいだけなら、ブラウザで Base64 デコーダー に文字列を貼り付けてください。
よくある質問
Base64 の MCP サーバーとは何ですか?
Model Context Protocol を話し、AI アシスタントに Base64 ツールを提供する小さなプログラムです。アシスタントはエンコードやデコードが必要になるとツールを呼び出し、文字を予測する代わりに正確な答えを受け取ります。
base64hub-mcp はデータをどこかに送りますか?
送りません。MCP クライアントが起動するローカルのプロセスとして動き、標準入力と標準出力でやり取りします。ダウンロードが発生するのは、初めて npx が実行するときの npm パッケージ本体だけです。
どの AI クライアントで使えますか?
stdio の MCP サーバーを起動できるクライアントならどれでも使えます。Claude Desktop、Claude Code、Cursor、VS Code 用の設定例は MCP サーバーのドキュメント にあります。
デコードしたデータがテキストでない場合はどうなりますか?
base64_decode は、UTF-8 ではないという注記を付けてバイト列を 16 進数で返します。そのため、アシスタントが文字化けした文字をテキストとして示すことはありません。