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-safe 알파벳(-와 _). |
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이며 구조화된 콘텐츠(structured content)로도 전송됩니다.
| 필드 | 의미 |
|---|---|
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="}]}}
서버는 npm에 base64hub-mcp로, MCP Registry에 com.base64hub/mcp로 게시되어 있습니다.
업데이트 2026. 11. 22.