Skip to main content
Glama
mcp-base64

mcp-base64

by Wuodan

MCP Base64 Server

A Python MCP (Model Context Protocol) server for Base64 file conversion with stdio transport.

Features

  • encode_file_to_base64: Encode any file to base64 string

  • decode_base64_to_file: Decode base64 content to file

  • Binary-safe: Handles both text and binary files correctly

Related MCP server: MCP File Upload Sample

Usage

IDE Configuration

For IDE plugins, add this server to your MCP configuration JSON:

{
  "mcpServers": {
    "base64": {
      "command": "uvx",
      "args": [
        "mcp-base64"
      ]
    }
  }
}

Direct Execution

git clone https://github.com/Wuodan/mcp-base64.git
cd mcp-base64
python3 -m venv .venv
./.venv/bin/python -m pip install -e .
./.venv/bin/python -m mcp_base64.server

Tools

encode_file_to_base64(file_path: str) -> str

Encodes a file to base64 string.

Parameters:

  • file_path (str): Absolute path to file to encode

Returns: Base64 encoded string

decode_base64_to_file(base64_content: str, file_path: str) -> str

Decodes base64 string to file.

Parameters:

  • base64_content (str): Base64 encoded content

  • file_path (str): Absolute path where to save decoded file

Returns: Success message with file path

Development

Install development dependencies:

./.venv/bin/python -m pip install -r requirements-dev.txt -e .

Run tests:

./.venv/bin/python -m pytest -q

Run linting:

./scripts/lint.sh

Available Tools

2 tools
decode_base64_to_fileDecode Base64 To FileA

Decode a base64 string and write it to a file.

This tool takes base64 encoded content and writes the decoded binary data to a file. Only absolute paths are allowed for security reasons.

Inputs: file_path (required), base64_content (required). Returns: result

encode_file_to_base64Encode File To Base64A

Encode a file to a base64 string.

This tool reads a file in binary mode and returns its contents encoded as a base64 string. Only absolute paths are allowed for security reasons.

Inputs: file_path (required). Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.4/5.0

    Scored across 2 tools

    Disambiguation5/5

    The two tools are exact opposites with non-overlapping purposes: one encodes a file to base64, the other decodes base64 to a file. There is no ambiguity about which tool to select for a given direction.

    Naming Consistency5/5

    Both names follow the same verb_object_preposition_object pattern: encode_file_to_base64 and decode_base64_to_file. The naming is symmetric, predictable, and clearly indicates the input and output of each operation.

    Tool Count5/5

    Two tools is exactly the right scope for a focused base64 file conversion server. Each tool earns its place, and adding more tools would likely introduce redundancy or scope creep.

    Completeness5/5

    The server fully covers its stated domain: converting between file contents and base64 strings in both directions. There are no obvious missing operations for a file-based base64 utility.

    Maintenance

    ActivityActive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      A simple and efficient MCP server that provides Base64 encoding and decoding functionality for both text and images with support for Data URL format.
      4
      3
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables encoding and decoding of text between Base64, Base64URL, Base32, and Hex formats, supporting offline keyless operations.
      109 npm
      MIT
    • A
      license
      A
      quality
      Not graded
      maintenance
      Provides essential utility functions for AI development workflows, including UUID generation, Base64 encoding/decoding, timestamp conversion, and hash computation.
      7
      MIT