ファイルを選択
  1. base64hub
  2. ドキュメント
  3. MCP サーバー

MCP サーバー リファレンス

base64hub-mcp は、読み取り専用のツールを 3 つ持つローカルの 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、1 つのプロジェクト用は .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 サーバーを起動できる他のクライアントでも、同じコマンドと引数で動きます。

ツール

3 つのツールはどれも読み取り専用で、オフラインで動きます。

base64_encode

テキストを UTF-8 として Base64 にエンコードします。

引数型デフォルト意味
textstring必須エンコードするテキスト。
url_safebooleanfalseURLセーフなアルファベット(- と _)。
paddingbooleantrue= パディングを付ける。
wrapinteger0N 文字ごとに改行を入れる。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 でない場合は、結果にその旨が書かれ、バイト列が 16 進数で示されます。+/+/ の場合は次のとおりです。

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 で、構造化コンテンツとしても送られます。

フィールド意味
validbase64_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 で、1 行に 1 メッセージ、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="}]}}

サーバーは npm では base64hub-mcp、MCP Registry では com.base64hub/mcp という名前で公開されています。

更新日 2026/11/22