文档转换服务

基本能力

产品定位

MCP - DOCX/PDF文档生成服务是一个后端服务，旨在将标准Markdown文本高质量地转换为DOCX或PDF格式的文档。

核心功能

• 高质量转换：基于强大的Pandoc和LaTeX（xelatex）引擎，确保Markdown中的各种元素（标题、列表、代码、表格、数学公式等）正确转换。
• 格式支持：支持生成常见的.docx文件和高质量的.pdf文件。
• 中英文字体自定义：允许用户为文档内容指定单独的中文和英文字体，解决混合语言排版中的常见问题。
• 自动化依赖管理：服务在启动时自动检查和安装所需的系统级依赖（如Pandoc、LaTeX、字体库等），简化部署过程。
• Web界面和API：提供简单的Gradio Web界面用于快速测试和手动转换，其架构也易于被其他程序作为API服务调用。

适用场景

• 将大型语言模型生成的Markdown内容转换为正式文档。
• 需要高质量排版的技术报告、学术论文等文档生成。
• 自动化文档生成流程中的格式转换环节。

使用教程

使用依赖

1. 操作系统：Debian或基于Debian的Linux发行版（如Ubuntu）。
2. Python：Python 3.x。
3. 权限：需要root或sudo权限来安装系统依赖。

安装教程

1. 克隆或下载项目：
   复制

   git clone [项目地址]
   

2. 准备requirements.txt：
   复制

   gradio
   pypandoc
   python-docx
   path.py
   

3. 安装Python依赖：
   复制

   pip install -r requirements.txt
   

4. 安装系统依赖（自动）： 无需手动安装！脚本在首次启动时会自动调用apt-get安装所有所需的系统级包。

启动服务

python mcp_service.py

调试方式

1. 访问Web界面：http://127.0.0.1:7860。
2. 使用API调用：发送POST请求到http://your-server-ip:7860/api/predict。