File Converter MCP

🚀 文件轉換器

這是一個功能強大的文件轉換工具，支持多種文件格式之間的相互轉換。它能為用戶提供高效、可靠的文件處理解決方案。

🚀 快速開始

本文件轉換器支持多種文件格式之間的相互轉換，為你提供高效、可靠的文件處理解決方案。

✨ 主要特性

多格式支持

工具支持以下主要功能：

• 文檔轉換：Word、PDF、HTML/Markdown 互轉。
• 數據導出：將 CSV 文件導出為其他格式。

靈活的輸入方式

用戶可以選擇兩種方式提供文件：

1. 路徑輸入

   @文件轉換器
   docx2pdf
   input_file: file.docx
   

2. 內容輸入（Base64）

   @文件轉換器
   docx2pdf_content
   file_content_base64: 含有文件內容的Base64字符串
   

高效處理流程

1. 文件解析：自動識別文件格式。
2. 內容轉換：使用合適工具進行格式轉換。
3. 結果輸出：返回 Base64 編碼的轉換後文件。

錯誤處理

• 輸入驗證：確保文件路徑和內容有效。
• 異常捕捉：記錄詳細錯誤信息，便於排查問題。
• 恢復機制：處理失敗時自動清理臨時文件。

高可用性設計

• 容錯機制：採用多線程處理任務，防止系統崩潰。
• 負載均衡：支持高併發請求，保證服務穩定。

📦 安裝指南

通過 Git 克隆倉庫

git clone https://github.com/wowyuarm/file-converter-mcp.git
cd file-converter-mcp

依賴管理

項目使用 poetry 管理依賴，推薦安裝最新版本：

curl -L https://get-poetry.py | python
poetry install

💻 使用示例

基礎用法

1. 啟動服務

   poetry run start
   

2. 使用工具

   @文件轉換器
   工具名
   輸入參數：值
   

高級用法

將 Word 文件轉換為 PDF：

@文件轉換器
docx2pdf
input_file: file.docx

📚 詳細文檔

項目結構

file-converter-mcp/
├── main.py          # 主程序入口
├── config/         # 配置文件夾
│   ├── settings.py # 應用配置
│   └── logging.py   # 日誌配置
├── converters/     # 各種格式轉換器實現
│   ├── docx_to_pdf.py
│   ├── html_to_pdf.py
│   └── csv_to_xlsx.py
└── utils/          # 工具函數
    ├── file_handler.py
    └── base64_utils.py

支持的文件格式

• Microsoft Word (docx)
• Adobe PDF (pdf)
• HTML 和 Markdown (md, markdown)
• CSV (csv)

🤝 貢獻指南

歡迎各位開發者參與項目！如需貢獻，請參考 CONTRIBUTING.md。

📄 許可證

本項目遵循 MIT 許可證，具體內容請參閱 LICENSE 文件。

🌐 項目地址

GitHub 倉庫：https://github.com/wowyuarm/file-converter-mcp