Base64 编码与解码 MCP 服务器

英文版

一个简单高效的 MCP 服务器，专注于提供 Base64 编码和解码功能，支持文本和图像的 Base64 转换。

<a href="https://glama.ai/mcp/servers/@liuyazui/base64_server"> <img width="380" height="200" src="https://gips0.baidu.com/it/u=782897415,629196144&fm=3081&app=3081&f=PNG?w=760&h=400" alt="Base64 Server MCP 服务器" /> </a>

功能

• 文本 Base64 编码和解码
• 图像 Base64 编码和解码
• 支持 Data URL 格式
• 简单易用的 API
• 使用 UV 进行依赖管理

安装

使用 UV 安装

# 创建虚拟环境
uv venv

# 激活虚拟环境（Linux/macOS）
source .venv/bin/activate

# 激活虚拟环境（Windows）
.venv\Scripts\activate

# 安装包（开发模式）
uv pip install -e .

# 安装带有开发依赖的包
uv pip install -e ".[dev]"

安装 Smithery

使用 Smithery 安装 Base64 编码器 MCP 服务器到 Claude 的桌面，使用以下命令：

npx -y @smithery/cli install @liuyazui/base64_server --client claude

使用说明

使用 MCP Inspector 测试

# 使用 MCP Inspector 测试服务器
uv run mcp dev base64_server.py

集成 MCP 客户端

1. 添加服务器配置：

   {
     "mcpServers": {
        "base64-encoder": {
        "command": "uv",
        "args": [
          "run",
          "--with",
          "mcp[cli]",
          "mcp",
          "run",
          "[base64_server.py 的路径]"
        ]
      }
     }
   }
   

API 参考

工具

• base64_encode_text(text: str) -> str 将文本转换为 Base64 编码
• base64_decode_text(encoded: str) -> str 将 Base64 编码解码为文本
• base64_encode_image(image_path: str) -> str 将图像转换为 Base64 编码
• base64_decode_image(encoded: str, output_path: str, mime_type: str = "image/png") -> str 将 Base64 编码解码为图像

资源

• encode://base64/text/{text}: 获取文本的 Base64 编码
• decode://base64/text/{encoded}: 获取 Base64 编码的解码结果
• encode://base64/image/{image_path}: 获取图像的 Base64 编码
• decode://base64/image/{encoded}: 获取 Base64 编码的解码图像

提示模板

• base64_usage_guide(): 提供 Base64 服务的基本使用指南
• encode_text_prompt(text: str): 文本编码提示模板
• encode_image_prompt(image_path: str): 图像编码提示模板
• error_handling_prompt(error_message: str): 错误处理提示模板

使用示例：

# 获取使用指南提示
messages = await client.get_prompt("base64_usage_guide")

# 获取文本编码提示
messages = await client.get_prompt("encode_text_prompt", {"text": "Hello World"})

开发

许可证

MIT