🚀 Pandoc 多服务器控制协议（MCP）服务器

Pandoc-MCP 服务器是一款基于 Pandoc 的实用工具，可实现多种文件格式的转换与处理。它不仅能完成文件格式的转换，还可与 LangChain 等 MCP 客户端集成，为用户提供便捷的文件处理体验。

🚀 快速开始

若您想快速体验 Pandoc-MCP 服务器，可按以下步骤操作：

步骤一：构建 Docker 镜像

docker build -t your_username/pandoc-mcp-server .

步骤二：运行容器

docker run -it --rm -v $(pwd):/data your_username/pandoc-mcp-server:latest

✨ 主要特性

• 多格式转换：支持 Markdown、Word、PDF 等格式文件的相互转换，满足多样化的文件处理需求。
• 远程控制：借助 HTTP 协议提供服务，可远程调用文件处理功能，方便快捷。
• Docker 支持：提供 Docker 镜像构建方案，便于快速部署和运行，节省时间和精力。
• 文档管理：支持批量处理、版本控制和文档存储，有效管理文档资源。

📦 安装指南

服务器端安装

方案一：基于 Docker 的安装（推荐）

此方案简单便捷，适合快速部署。

1. 拉取镜像

   docker pull your_username/pandoc-mcp-server:latest
   

2. 启动容器

   docker run -it --rm -v $(pwd):/data your_username/pandoc-mcp-server:latest
   

3. 访问服务：服务器启动后，可通过 http://localhost:8000/sse 访问服务。

方案二：本地安装（需手动配置）

若您希望手动配置服务器，可选择此方案。

1. 安装依赖
   • 安装 Python 3.10 或更高版本。
   • 安装 Pandoc 工具链 (pandoc --version)。
   • 安装 LaTeX 环境 (pdflatex --version)。
2. 克隆代码库

   git clone https://github.com/your_username/pandoc-mcp-server.git
   cd pandoc-mcp-server
   

3. 创建虚拟环境（推荐）

   python -m venv venv
   source venv/bin/activate  # Linux/macOS
   # 或者：venv\Scripts\activate  # Windows
   

4. 安装 Python 包

   pip install -r requirements.txt
   

5. 启动服务器

   python pandoc_mcp_server.py
   

💻 使用示例

客户端集成示例（以 LangChain 为例）

from langchain.agents import MultiServerMCPClient

# 初始化客户端
client = MultiServerMCPClient(
    server_url="http://localhost:8000/sse",
    token="your_token"
)

# 调用文件转换服务
response = client.invoke("将 input.md 转换为 PDF")
print(response)

📚 详细文档

1. 文件格式转换

• 支持的格式：Markdown、.docx、PDF 等。
• 使用命令

  # 将 markdown 转换为 PDF
  ./pandoc-mcp convert input.md output.pdf --format=pdf
  
  # 批量处理文件
  ./pandoc-mcp batch process *.md output/
  

2. 文档管理

• 版本控制：支持文件的历史版本管理，方便追溯和恢复。
• 存储位置：默认存储在 /data/documents 目录。

3. 高级功能

• 自定义模板：通过配置 templates 目录，可使用自定义的 Pandoc 模板，满足个性化需求。
• 日志记录：服务器支持详细的日志输出，便于调试和监控。

示例场景

场景一：在线文档转换服务

# 启动服务并绑定端口 8000
docker run -it --rm -p 8000:8000 your_username/pandoc-mcp-server:latest

场景二：批量处理 Word 文件

# 将当前目录下所有 .docx 文件转换为 PDF
./pandoc-mcp batch convert *.docx output/pdf/

🔧 技术细节

项目结构

.
├── pandoc_mcp_server.py    # 主程序入口
├── requirements.txt        # Python 依赖管理
├── Dockerfile              # Docker 镜像构建文件
└── templates/             # Pandoc 模板目录

📄 常见问题

1. 如何获取帮助？
   • 查看 pandoc-mcp --help。
   • 加入项目社区讨论组或提交 ISSUE。
2. 如何处理错误？
   • 检查日志输出 (docker logs)。
   • 确保所有依赖已正确安装。

🤝 项目贡献

欢迎 fork 和 PR！您可以：

• 提交功能增强。
• 修复已知问题。
• 添加更多文件格式支持。

通过以上步骤，您可以轻松地搭建和使用 Pandoc-MCP 服务器，实现高效的文档管理和转换。