基本能力
产品定位
MCP - DOCX/PDF文档生成服务是一个后端服务,旨在将标准Markdown文本高质量地转换为DOCX或PDF格式的文档。
核心功能
- 高质量转换:基于强大的
Pandoc和LaTeX(xelatex)引擎,确保Markdown中的各种元素(标题、列表、代码、表格、数学公式等)正确转换。 - 格式支持:支持生成常见的
.docx文件和高质量的.pdf文件。 - 中英文字体自定义:允许用户为文档内容指定单独的中文和英文字体,解决混合语言排版中的常见问题。
- 自动化依赖管理:服务在启动时自动检查和安装所需的系统级依赖(如Pandoc、LaTeX、字体库等),简化部署过程。
- Web界面和API:提供简单的Gradio Web界面用于快速测试和手动转换,其架构也易于被其他程序作为API服务调用。
适用场景
- 将大型语言模型生成的Markdown内容转换为正式文档。
- 需要高质量排版的技术报告、学术论文等文档生成。
- 自动化文档生成流程中的格式转换环节。
使用教程
使用依赖
- 操作系统:Debian或基于Debian的Linux发行版(如Ubuntu)。
- Python:Python 3.x。
- 权限:需要
root或sudo权限来安装系统依赖。
安装教程
- 克隆或下载项目:
git clone [项目地址]- 准备
requirements.txt:
gradio
pypandoc
python-docx
path.py- 安装Python依赖:
pip install -r requirements.txt- 安装系统依赖(自动):
无需手动安装!脚本在首次启动时会自动调用apt-get安装所有所需的系统级包。
启动服务
python mcp_service.py调试方式
- 访问Web界面:
http://127.0.0.1:7860。 - 使用API调用:发送POST请求到
http://your-server-ip:7860/api/predict。
