File Converter MCP Server

基本能力

产品定位

File Converter MCP Server 是一个多功能文件转换工具，旨在为 AI 代理和开发者提供高效的文件格式转换服务。

核心功能

• DOCX 到 PDF 转换：将 Microsoft Word 文档转换为 PDF 格式。
• PDF 到 DOCX 转换：将 PDF 文档转换为 Microsoft Word 格式。
• 图像格式转换：支持 JPG、PNG、WebP 等图像格式之间的转换。
• Excel 到 CSV 转换：将 Excel 电子表格转换为 CSV 格式。
• HTML 到 PDF 转换：将 HTML 文件转换为 PDF 格式。
• Markdown 到 PDF 转换：将 Markdown 文档转换为带有适当样式的 PDF。
• 通用文件转换：支持多种格式的通用转换工具。

适用场景

• AI 代理需要处理多种文件格式的场景。
• 开发者需要快速转换文件格式的开发环境。
• 自动化工作流中需要文件格式转换的环节。

工具列表

1. docx2pdf：将 DOCX 文件转换为 PDF。
2. pdf2docx：将 PDF 文件转换为 DOCX。
3. convert_image：转换图像格式。
4. excel2csv：将 Excel 文件转换为 CSV。
5. html2pdf：将 HTML 文件转换为 PDF。
6. convert_file：通用文件转换工具。
7. convert_content：基于内容的通用转换工具（向后兼容）。
8. docx2pdf_content：基于内容的 DOCX 到 PDF 转换。
9. pdf2docx_content：基于内容的 PDF 到 DOCX 转换。
10. markdown2pdf_content：基于内容的 Markdown 到 PDF 转换。

常见问题解答

• 文件找不到：尝试使用绝对路径或直接提供文件的 Base64 编码内容。
• 转换失败：检查输入文件格式是否正确，或查看详细的错误日志。
• 依赖问题：确保所有系统依赖已安装，如 wkhtmltopdf 对于 HTML 到 PDF 转换。

使用教程

使用依赖

1. Python 3.10+：确保系统已安装 Python 3.10 或更高版本。
2. 系统依赖：某些转换工具可能需要额外的系统依赖，如 wkhtmltopdf。

安装教程

1. 克隆仓库 bash git clone https://github.com/wowyuarm/file-converter-mcp.git cd file-converter-mcp
2. 创建虚拟环境（推荐） bash python -m venv venv source venv/bin/activate # Unix-based 系统 venv\Scripts\activate # Windows 系统
3. 安装依赖 bash pip install mcp docx2pdf pdf2docx pillow pandas pdfkit markdown 或使用 uv： bash uv add "mcp[cli]" docx2pdf pdf2docx pillow pandas pdfkit markdown

调试方式

1. 开发模式运行服务器 bash mcp dev file_converter_server.py
2. 安装到 Claude Desktop bash mcp install file_converter_server.py --name "File Converter"
3. 测试工具 使用具体的工具命令进行测试，例如： bash @File Converter docx2pdf input_file: path/to/document.docx 或使用 Base64 编码内容： bash @File Converter docx2pdf file_content_base64: [base64 encoded string]

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。