File Converter MCP

🚀 File Converter

A powerful file conversion tool that supports mutual conversion between multiple file formats, aiming to provide users with an efficient and reliable file processing solution.

🚀 Quick Start

This is a powerful file conversion tool that supports mutual conversion between multiple file formats. The project aims to provide users with an efficient and reliable file processing solution.

✨ Features

Multi-format Support

The tool supports the following main functions:

• Document Conversion: Convert between Word, PDF, HTML, and Markdown.
• Data Export: Export CSV files to other formats.

Flexible Input Modes

Users can choose two ways to provide files:

1. Path Input

   @File Converter
   docx2pdf
   input_file: file.docx
   

2. Content Input (Base64)

   @File Converter
   docx2pdf_content
   file_content_base64: Base64 string containing file content
   

Efficient Processing Flow

1. File Parsing: Automatically identify the file format.
2. Content Conversion: Use appropriate tools for format conversion.
3. Result Output: Return the converted file encoded in Base64.

📦 Installation

Clone the Repository via Git

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

Dependency Management

The project uses poetry to manage dependencies. It is recommended to install the latest version:

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

💻 Usage Examples

Basic Usage

1. Start the Service

   poetry run start
   

2. Use the Tool

   @File Converter
   Tool Name
   Input Parameter: Value
   

Example

Convert a Word file to PDF:

@File Converter
docx2pdf
input_file: file.docx

🔧 Technical Details

Error Handling

• Input Validation: Ensure that the file path and content are valid.
• Exception Capture: Record detailed error information for easy troubleshooting.
• Recovery Mechanism: Automatically clean up temporary files when processing fails.

High Availability Design

• Fault Tolerance Mechanism: Use multi-threading to process tasks and prevent system crashes.
• Load Balancing: Support high-concurrency requests to ensure service stability.

Project Structure

file-converter-mcp/
├── main.py          # Main program entry
├── config/         # Configuration folder
│   ├── settings.py # Application configuration
│   └── logging.py   # Log configuration
├── converters/     # Implementations of various format converters
│   ├── docx_to_pdf.py
│   ├── html_to_pdf.py
│   └── csv_to_xlsx.py
└── utils/          # Utility functions
    ├── file_handler.py
    └── base64_utils.py

🤝 Contribution Guide

All developers are welcome to contribute to the project! If you want to contribute, please refer to CONTRIBUTING.md.

📄 License

This project is licensed under the MIT License. Please refer to the LICENSE file for details.

🌐 Project Address

GitHub Repository: https://github.com/wowyuarm/file-converter-mcp