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 # 依赖锁定文件