README.md•2.88 kB
# Base64编码解码MCP服务器
[](https://smithery.ai/server/@liuyazui/base64_server)
[English Version](README_EN.md)
一个简单高效的MCP服务器,专注于提供Base64编码和解码功能,支持文本和图片的Base64转换。
<a href="https://glama.ai/mcp/servers/@liuyazui/base64_server">
<img width="380" height="200" src="https://glama.ai/mcp/servers/@liuyazui/base64_server/badge" alt="Base64 Server MCP server" />
</a>
## 功能特点
- 文本Base64编码和解码
- 图片Base64编码和解码
- 支持Data URL格式
- 简单易用的API
- 使用uv进行依赖管理
## 安装
### 使用uv安装
```bash
# 创建虚拟环境
uv venv
# 激活虚拟环境(Linux/macOS)
source .venv/bin/activate
# 激活虚拟环境(Windows)
.venv\Scripts\activate
# 安装包(开发模式)
uv pip install -e .
# 安装带开发依赖的包
uv pip install -e ".[dev]"
```
### 安装Smithery
使用Smithery为Claude桌面安装Base64编码解码MCP服务器,使用以下命令:
```bash
npx -y @smithery/cli install @liuyazui/base64_server --client claude
```
## 使用方法
### 使用MCP Inspector测试
```bash
# 使用MCP Inspector测试服务器
uv run mcp dev base64_server.py
```
### 与MCP client集成
1. 添加服务器配置:
```json
{
"mcpServers": {
"base64-encoder": {
"command": "uv",
"args": [
"run",
"--with",
"mcp[cli]",
"mcp",
"run",
"[path to base64_server.py]"
]
}
}
}
```
## API参考
### 工具(Tools)
- **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编码解码为图片
### 资源(Resources)
- **encode://base64/text/{text}**:获取文本的Base64编码
- **decode://base64/text/{encoded}**:获取Base64编码的解码结果
- **encode://base64/image/{image_path}**:获取图片的Base64编码
- **decode://base64/image/{encoded}**:获取Base64编码的解码图片
### 提示模板(Prompts)
- **base64_usage_guide()**: 提供Base64服务的基本使用指南
- **encode_text_prompt(text: str)**: 文本编码提示模板
- **encode_image_prompt(image_path: str)**: 图片编码提示模板
- **error_handling_prompt(error_message: str)**: 错误处理提示模板
使用示例:
```python
# 获取使用指南提示
messages = await client.get_prompt("base64_usage_guide")
# 获取文本编码提示
messages = await client.get_prompt("encode_text_prompt", {"text": "Hello World"})
```
## 开发
## 许可证
MIT