Converter MCP - 文件转换服务器

基于 FastMCP 框架的 CSV 和 Excel 文件转换工具，提供简单易用的文件格式转换服务。

功能特性

本项目提供以下两个核心转换工具：

1. CSV 转 Excel

将 CSV 文件转换为 Excel (.xlsx) 格式。

特点：

• 支持多种字符编码自动检测（UTF-8, UTF-16, GBK, GB2312, CP936）
• 自动处理中文编码问题
• 保留所有数据类型为字符串格式

2. Excel 转 CSV

将 Excel (.xlsx) 文件转换为 CSV 格式。

特点：

• 支持多工作表处理，每个工作表生成独立的 CSV 文件
• 自动回退机制：如果文件不是有效的 Excel 格式，会尝试按 CSV 格式读取
• 智能编码检测和处理

技术架构

中间件支持

服务器集成了多个中间件以提供稳定可靠的服务：

• 错误处理中间件：统一的错误处理机制
• 速率限制中间件：限制每秒最多 10 个请求
• 计时中间件：性能监控
• 日志中间件：完整的请求日志记录

传输协议

使用 SSE (Server-Sent Events) 协议，在 0.0.0.0:8000 端口上运行。

环境要求

• Python >= 3.12
• 主要依赖：
  • fastmcp==2.12.0
  • pandas>=2.3.3
  • openpyxl>=3.1.5
  • pydantic>=2.12.4

安装与运行

方式一：使用 Docker（目前不支持，dockerfile有问题）

# 构建镜像
docker build -t converter-mcp .

# 运行容器
docker run -p 8000:8000 -v /path/to/your/files:/app/data converter-mcp

方式二：本地运行（推荐）

# 使用 uv 安装依赖
uv sync

# 运行服务器
uv run main.py

配置选项

日志级别

可以通过环境变量配置日志级别。

支持的日志级别：DEBUG, INFO, WARNING, ERROR, CRITICAL（默认：INFO）

# 设置日志级别
export LOG_LEVEL=DEBUG
python main.py

使用示例

CSV 转 Excel

# 输入：data.csv
# 输出：data.xlsx（在同一目录下）

Excel 转 CSV

# 输入：workbook.xlsx（包含多个工作表）
# 输出：workbook_Sheet1.csv, workbook_Sheet2.csv, ...

错误处理

服务器实现了完善的错误处理机制：

• 文件路径验证
• 文件格式检查
• 编码自动检测
• 详细的错误日志记录

项目结构

converter-mcp/
├── main.py              # 服务器入口点
├── src/
│   ├── server.py        # MCP 服务器配置
│   ├── tools.py         # 转换工具实现
│   └── settings.py      # 配置管理
├── Dockerfile           # Docker 配置
├── pyproject.toml       # 项目依赖配置
└── uv.lock             # 依赖锁定文件