convertfilefast

ConvertFileFast MCP サーバー

ConvertFileFast 用の MCP サーバーです。AI エージェントが ConvertFileFast REST API を通じて、ファイル変換、PDF／画像操作、Stripe の請求リンク作成、フィードバックの送信を行えます。

エージェントが選ぶ理由

• 1 つのツールで 50 種類以上の変換に対応 — convert_file は出力形式に応じて処理を振り分けるため、モデルはスラッグを暗記する代わりに「PPTX の URL があるので、PDF にしてください」と指示できます。
• URL を渡して、URL を受け取る — 公開 source_url を渡すと、有効期間の短い download_url が返されます。バイナリがエージェントのコンテキストウィンドウに保存されることはありません。
• 従量課金で低価格 — プリペイドクレジットは変換 1 回あたり約 $0.003 からで、月 10 回まで無料です。ユーザーライセンスは不要です。
• 安全性を考慮した設計 — ユーザーごとの cff_ API キー（リモートサーバーで共有・保存されることはありません）、SSRF 検証済みの URL 入力、決定論的なサーバー側変換を採用しています。
• セルフサービスでチャージ — クレジットがなくなると、エージェントは get_billing_status と create_credit_pack_checkout を呼び出し、Stripe リンクを返します。

エージェントから利用する

サーバーを追加すると（下記のインストールを参照）、次のようなプロンプトをそのまま使えます。

• 「https://example.com/contract.docx を PDF に変換してください。」
• 「この 3 つの PDF URL を、記載順に 1 つのファイルに結合してください。」
• 「この PDF は 40 MB あります。中品質に圧縮して、リンクを教えてください。」
• 「この PDF から表を抽出して、JSON にしてください。」
• 「この PNG の幅を 1200px に変更して、WebP を返してください。」

どちらのモードでも同じツールを利用できます。

• ローカル stdio：MCP サーバーがユーザーのマシン上で動作し、結果をローカルフォルダーに保存します。
• リモート HTTP：ConvertFileFast が https://mcp.convertfilefast.com/mcp で MCP サーバーをホストし、一時的なダウンロードリンクを返します。

ツール

ツール	API エンドポイント	結果
list_supported_conversions	ローカルマトリックス	JSON リスト
convert_file	/v2/convert/{from}-to-{to}	ファイル
images_to_pdf	/v2/convert/images-to-pdf	PDF
merge_pdfs	/v2/pdf/merge	PDF
split_pdf	/v2/pdf/split	ZIP
compress_pdf	/v2/pdf/compress	PDF
rotate_pdf	/v2/pdf/rotate	PDF
protect_pdf	/v2/pdf/protect	PDF
unlock_pdf	/v2/pdf/unlock	PDF
extract_pdf_text	/v2/pdf/extract-text	JSON
resize_image	/v2/image/resize	画像
compress_image	/v2/image/compress	画像
get_billing_status	/v2/billing/status	JSON
create_subscription_checkout	/v2/billing/checkout/subscription	Stripe Checkout URL
create_credit_pack_checkout	/v2/billing/checkout/credits	Stripe Checkout URL
create_billing_portal_link	/v2/billing/portal	Stripe Portal URL
report_feedback	/v2/feedback	JSON

ファイルを生成するツールはすべて、可能な場合は公開 source_url を受け付けます。クライアントから URL を公開できない場合は、代わりに base64 コンテンツを渡せます。 請求関連のツールがカード情報を収集することはありません。ユーザーが開いて支払いを確定できる、Stripe がホストする URL を返します。 report_feedback は、短い概要、カテゴリ、関連するツール、コンテキストを受け付けます。API キーなしでも実行できますが、クライアントから API キーが提供された場合は、そのキーも転送します。

対応している変換

正規の一覧はlist_supported_conversionsツールを使用して確認してください。現在のスラッグ：

avif-to-jpg、avif-to-pdf、avif-to-png、bmp-to-jpg、bmp-to-pdf、 bmp-to-png、csv-to-json、csv-to-pdf、csv-to-xlsx、doc-to-pdf、 docx-to-pdf、docx-to-txt、heic-to-jpg、heic-to-pdf、heic-to-png、html-to-pdf、 images-to-pdf、jpg-to-pdf、jpg-to-png、jpg-to-webp、json-to-csv、 markdown-to-pdf、odt-to-pdf、pdf-to-csv、pdf-to-docx、pdf-to-jpg、 pdf-to-png、pdf-to-txt、pdf-to-xlsx、png-to-jpg、png-to-pdf、 png-to-webp、ppt-to-pdf、pptx-to-pdf、rtf-to-pdf、svg-to-jpg、 svg-to-pdf、svg-to-png、tiff-to-jpg、tiff-to-pdf、tiff-to-png、 txt-to-pdf、url-to-pdf、webp-to-jpg、webp-to-pdf、webp-to-png、 xlsx-to-csv、xlsx-to-pdf

認証

ConvertFileFast API キーを次の場所で作成してください：

https://www.convertfilefast.com/signup

ローカルの stdio では、次を使用します：

CONVERTFILEFAST_API_KEY=cff_...

リモート HTTP では、次のいずれかを使用します：

X-API-Key: cff_...

または：

Authorization: Bearer cff_...

リモート MCP サーバーは API キーを保存しません。各ツール呼び出しで、キーをapi.convertfilefast.comに転送します。

リモート MCP

MCP クライアントがリモートの Streamable HTTP サーバーに対応している場合は、こちらを使用してください：

{
  "mcpServers": {
    "convertfilefast": {
      "url": "https://mcp.convertfilefast.com/mcp",
      "headers": {
        "X-API-Key": "cff_REPLACE_WITH_YOUR_KEY"
      }
    }
  }
}

リモートのファイル結果は次のようになります：

{
  "status": "success",
  "download_url": "https://mcp.convertfilefast.com/download/...",
  "filename": "converted.pdf",
  "bytes": 12345,
  "expires_in_seconds": 3600
}

ローカル stdio のインストール

推奨：

{
  "mcpServers": {
    "convertfilefast": {
      "command": "uvx",
      "args": ["convertfilefast-mcp"],
      "env": {
        "CONVERTFILEFAST_API_KEY": "cff_REPLACE_WITH_YOUR_KEY"
      }
    }
  }
}

npm ランチャーを使用する代替方法：

{
  "mcpServers": {
    "convertfilefast": {
      "command": "npx",
      "args": ["-y", "convertfilefast-mcp"],
      "env": {
        "CONVERTFILEFAST_API_KEY": "cff_REPLACE_WITH_YOUR_KEY"
      }
    }
  }
}

ローカルのファイル結果は次のようになります：

{
  "status": "success",
  "output_path": "/Users/me/ConvertFileFast/converted.pdf",
  "filename": "converted.pdf",
  "bytes": 12345
}

環境変数

変数	デフォルト	用途
CONVERTFILEFAST_API_BASE	https://api.convertfilefast.com	REST API のベース URL
CONVERTFILEFAST_API_KEY	空	ローカル stdio の API キー
CONVERTFILEFAST_OUTPUT_DIR	~/ConvertFileFast	ローカルの出力ディレクトリ
CONVERTFILEFAST_TIMEOUT	180	リクエストごとのタイムアウト（秒）
CONVERTFILEFAST_MCP_TRANSPORT	stdio	stdio、streamable-http、http、またはsse
CONVERTFILEFAST_MCP_HOST	0.0.0.0	HTTP のバインド先ホスト
CONVERTFILEFAST_MCP_PORT	8000	HTTP のバインドポート
CONVERTFILEFAST_MCP_PATH	/mcp	HTTP MCP エンドポイント
CONVERTFILEFAST_REMOTE_MODE	false	一時的なダウンロード URL を返します
CONVERTFILEFAST_DOWNLOAD_BASE	https://mcp.convertfilefast.com	ダウンロード用の公開ベース URL
CONVERTFILEFAST_TEMP_DIR	/tmp/convertfilefast-mcp	リモートの一時ファイル保存先
CONVERTFILEFAST_DOWNLOAD_TTL	3600	ダウンロード URL の有効期間（秒）
CONVERTFILEFAST_MAX_BASE64_MB	60	base64 デコード後の最大ペイロードサイズ

ローカル開発

uv run --with fastmcp --with httpx --with pydantic python server.py

テストを実行します：

uv run --with fastmcp --with httpx --with pydantic --with pytest pytest tests -q

リモートモードをローカルで実行します：

CONVERTFILEFAST_MCP_TRANSPORT=streamable-http \
CONVERTFILEFAST_REMOTE_MODE=true \
CONVERTFILEFAST_DOWNLOAD_BASE=http://127.0.0.1:8000 \
uv run --with fastmcp --with httpx --with pydantic python server.py

次に確認します：

curl http://127.0.0.1:8000/health

---

mcp-name: io.github.MLTCorp/convertfilefast