MCP サーバー リファレンス
base64hub-mcp は、読み取り専用のツールを 3 つ持つローカルの 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、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 にエンコードします。
| 引数 | 型 | デフォルト | 意味 |
|---|---|---|---|
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 でない場合は、結果にその旨が書かれ、バイト列が 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 で、構造化コンテンツとしても送られます。
| フィールド | 意味 |
|---|---|
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 で、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