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

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

Metadata

Release files for mcp-base64 0.1.7

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mcp-base64 0.1.7
File	Size	Uploaded	Provenance
mcp_base64-0.1.7.tar.gz	29.2 kB	Sep 19, 2026	With provenance	Details

Built distribution (wheel)

Table of built distributions (wheels) for mcp-base64 0.1.7
File	Interpreter	ABI	Platform	Reset
mcp_base64-0.1.7-py3-none-any.whl 12.6 kB Sep 19, 2026 With provenance	Python 3	none	any	Details

Total release size: 41.8 kB

Release files / mcp_base64-0.1.7.tar.gz

Download URL	mcp_base64-0.1.7.tar.gz
Size	29.2 kB
Tags	Source
SHA-256 checksum How to use checksums	`a2700804606b7b331b8f2e3f65478aa9ea796c17688c2c62119b5694eb8de321`
BLAKE2b-256 checksum How to use checksums	`d5293f3887acf5a3faa1455591bbb94d3ee55c05a5be7ad33583349f846c9f0a`
Upload date	Sep 19, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/Wuodan/mcp-base64
Publishing commit: github.com/Wuodan/mcp-base64/tree/9831e9284e14d462a3421f259aacc6f51b7a9dcc

Workflow

Publishing configuration: github.com/Wuodan/mcp-base64/blob/9831e9284e14d462a3421f259aacc6f51b7a9dcc/.github/workflows/release.yml
Publishing logs: github.com/Wuodan/mcp-base64/actions/runs/35466286803/attempts/1

Artifact

Subject: mcp_base64-0.1.7.tar.gz
SHA-256 checksum: a2700804606b7b331b8f2e3f65478aa9ea796c17688c2c62119b5694eb8de321 Verifying attestations

Release files / mcp_base64-0.1.7-py3-none-any.whl

Download URL	mcp_base64-0.1.7-py3-none-any.whl
Size	12.6 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`0326d29be6bfa3c3a111ae1b9393bd63d05f5e5cac442e8df2135106829024b7`
BLAKE2b-256 checksum How to use checksums	`79cab56b3c236a83b648d4139c31db2ec43a54f482608f48fb81d136fab09a99`
Upload date	Sep 19, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/Wuodan/mcp-base64
Publishing commit: github.com/Wuodan/mcp-base64/tree/9831e9284e14d462a3421f259aacc6f51b7a9dcc

Workflow

Publishing configuration: github.com/Wuodan/mcp-base64/blob/9831e9284e14d462a3421f259aacc6f51b7a9dcc/.github/workflows/release.yml
Publishing logs: github.com/Wuodan/mcp-base64/actions/runs/35466286803/attempts/1

Artifact

Subject: mcp_base64-0.1.7-py3-none-any.whl
SHA-256 checksum: 0326d29be6bfa3c3a111ae1b9393bd63d05f5e5cac442e8df2135106829024b7 Verifying attestations

Security for mcp-base64 0.1.7

Report project as malware

Provenance

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Attestation for mcp_base64-0.1.7.tar.gz

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/Wuodan/mcp-base64
Publishing commit: github.com/Wuodan/mcp-base64/tree/9831e9284e14d462a3421f259aacc6f51b7a9dcc

Workflow

Publishing configuration: github.com/Wuodan/mcp-base64/blob/9831e9284e14d462a3421f259aacc6f51b7a9dcc/.github/workflows/release.yml
Publishing logs: github.com/Wuodan/mcp-base64/actions/runs/35466286803/attempts/1

Artifact

Subject: mcp_base64-0.1.7.tar.gz
SHA-256 checksum: a2700804606b7b331b8f2e3f65478aa9ea796c17688c2c62119b5694eb8de321 Verifying attestations

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.