어시스턴트에 Base64 도구가 필요한 이유
모델은 Base64를 토큰 하나씩, 보통 다음에 올 것을 예측하며 씁니다. 짧고 흔한 문자열은 맞게 나오는 경우가 많지만 긴 문자열, ASCII가 아닌 텍스트, URL-safe 변형에서는 실수가 나오고, 문자 하나만 틀려도 바이트가 달라집니다. 도구를 호출하면 이 작업을 RFC 4648을 정확히 따르는 코드가 맡고, 어시스턴트는 그대로 인용할 수 있는 결과를 받습니다.
base64hub-mcp가 제공하는 도구는 세 가지입니다.
| 도구 | 인수 | 결과 |
|---|---|---|
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에서는 명령 하나로 끝납니다.
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 메시지를 주고받습니다. 클라이언트가 서버를 자식 프로세스로 시작하고 stdin과 stdout으로 메시지를 교환합니다. SDK 없이 직접 작성했고 의존성이 없으므로 npx는 작은 패키지 하나만 받아 옵니다. 네트워크 포트에서 대기하는 것은 없습니다. 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 클라이언트가 시작하는 로컬 프로세스로 실행되며 stdin과 stdout으로 클라이언트와 통신합니다. 다운로드하는 것은 npx가 처음 실행할 때 받는 npm 패키지 자체뿐입니다.
어떤 AI 클라이언트에서 쓸 수 있나요?
stdio MCP 서버를 실행할 수 있는 클라이언트라면 모두 됩니다. Claude Desktop, Claude Code, Cursor, VS Code용 설정은 MCP 문서에 준비되어 있습니다.
디코딩한 데이터가 텍스트가 아니면 어떻게 되나요?
base64_decode는 UTF-8이 아니라는 안내와 함께 바이트를 16진수로 돌려주므로, 어시스턴트가 깨진 문자를 텍스트인 것처럼 보여 주지 않습니다.