File Converter MCP

🚀 ファイルコンバーター

このプロジェクトは、様々なファイル形式間の相互変換をサポートする強力なファイル変換ツールです。ユーザーに効率的で信頼性の高いファイル処理ソリューションを提供することを目的としています。

🚀 クイックスタート

このファイルコンバーターは、多様なファイル形式の相互変換をサポートし、ユーザーに便利なファイル処理サービスを提供します。以下の手順ですぐに使い始めることができます。

✨ 主な機能

多形式サポート

このツールは以下の主要機能をサポートしています。

• ドキュメント変換：Word、PDF、HTML/Markdown の相互変換が可能です。
• データエクスポート：CSV ファイルを他の形式にエクスポートできます。

柔軟な入力方法

ユーザーは2種類の方法でファイルを提供することができます。

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

貢献ガイド

開発者の皆様からの貢献を歓迎します！貢献する場合は、CONTRIBUTING.md を参照してください。

📄 ライセンス

このプロジェクトは MIT ライセンスに基づいています。詳細は LICENSE ファイルを参照してください。

プロジェクトのURL

GitHub リポジトリ：https://github.com/wowyuarm/file-converter-mcp