파일 업로드
  1. base64hub
  2. 문서
  3. MCP 서버

MCP 서버 레퍼런스

base64hub-mcp는 읽기 전용 도구 세 개를 갖춘 로컬 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, 프로젝트 하나용은 .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로 인코딩합니다.

인수타입기본값의미
textstring필수인코딩할 텍스트.
url_safebooleanfalseURL-safe 알파벳(-와 _).
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이며 구조화된 콘텐츠(structured content)로도 전송됩니다.

필드의미
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이며, 한 줄에 메시지 하나씩 오가고 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.