FILE CONVERTER MCP

🚀 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 服務器，實現高效的文檔管理和轉換。