ChangeThisFile — file conversion between 690+ formats (hosted Streamable HTTP + stdio)

ChangeThisFile MCP サーバー

ChangeThisFile の7 つのファイルツールを、あらゆる MCP クライアントから利用できます。1,000 以上の対応ルートでの変換、ドキュメント翻訳、表の抽出、指定サイズへの圧縮、自然言語によるルーティング、ジョブのステータス確認に対応しています。

ChangeThisFile.com を利用しています。ディスカバリーと有料プレビューのジョブは公開されています。一般的な convert_file は、ネットワークごとに月 25 回までキーなしで利用できます。上限を超えると、無料の認証済み開発者キーが必要です（REST API と共有の月 25 回）。有料 API プランでは上限が引き上げられます。

ツール

ツール	説明
convert_file	ファイルを変換します。一般公開されている source_url または base64_content（最大約 5MB）と、target_format（例：pdf、mp3、json）を渡します。ソース形式は URL／ファイル名から自動検出されます。または、source_format を明示的に渡すこともできます。1 時間有効なダウンロード URL を返します。
list_conversions	対応している変換ルートをすべて一覧表示します。必要に応じて source_format で絞り込めます（例：docx → DOCX を変換できるすべての形式を表示）。
translate_file	レイアウトを維持したままドキュメントを翻訳します。無料プレビューと、完全な出力を取得するための一度限りのチェックアウトリンクを返します。
extract_tables	PDF または画像から表を抽出し、Excel 形式にします。無料プレビューと、完全な出力を取得するための一度限りのチェックアウトリンクを返します。
compress_file	PDF、画像、動画を、指定した最大サイズに圧縮します。1 日あたりの上限内で無料です。
do_file_job	平易な言葉で書かれたファイル操作の指示を、変換、翻訳、抽出、圧縮に振り分けます。
check_job	送信したジョブを確認し、プレビュー、チェックアウトリンク、またはダウンロード URL を取得します。

オプション 1 — リモートエンドポイント（推奨、インストール不要）

サーバーはストリーミング可能な HTTP トランスポート（MCP 仕様 2025-03-26）を使用して、https://changethisfile.com/mcp でホストされています。リモート MCP サーバーに対応しているクライアントなら、エンドポイントを直接指定してください。カスタムヘッダーに対応しているクライアントでは、認証済みの開発者利用量計測に Authorization: Bearer ctf_sk_... を送信できます。

{
  "mcpServers": {
    "changethisfile": {
      "type": "streamable-http",
      "url": "https://changethisfile.com/mcp"
    }
  }
}

Claude Code：

claude mcp add --transport http changethisfile https://changethisfile.com/mcp

オプション 2 — ローカル stdio サーバー（このパッケージ）

stdio のみをサポートするクライアント向けに、このパッケージは stdio とホストされたエンドポイントを中継します。

{
  "mcpServers": {
    "changethisfile": {
      "command": "npx",
      "args": ["-y", "github:aadilr/changethisfile-mcp"],
      "env": {
        "CTF_API_KEY": "ctf_sk_your_key_here"
      }
    }
  }
}

CTF_API_KEY は省略可能です。指定しない場合、ネットワークごとに月 25 回まで無料で変換できます。上限を超えると、convert_file でキーが求められます。ChangeThisFile ダッシュボードから認証済みの無料キーを取得してください（または {"email":"[email protected]"} を指定して POST https://changethisfile.com/v1/keys/free を実行し、認証メールのリンクをクリックしてください）。月 25 回の変換枠は、MCP と REST で共有されます。有料プランは月額 $29 からです。

または、クローンして直接実行します。

git clone https://github.com/aadilr/changethisfile-mcp.git
cd changethisfile-mcp
npm install
node index.js

オプション 3 — エージェントスキル／Claude Code プラグイン

このリポジトリは、エージェントスキルと Claude Code プラグインを兼ねています。

スキル対応エージェント（Claude Code、Codex CLI、Cursor、Gemini CLI、Copilot など）：

npx skills add aadilr/changethisfile-mcp

Claude Code プラグイン（MCP サーバーとスキルを同梱）：

/plugin marketplace add aadilr/changethisfile-mcp
/plugin install changethisfile@changethisfile

file-conversion スキルは、接続時には MCP ツールを優先し、それ以外の場合は同梱スクリプト（skills/file-conversion/scripts/convert.sh）にフォールバックします。このスクリプトは、MCP クライアントを使わずに、プレーンな HTTPS 経由でホストされたエンドポイントと通信します。

オプション 4 — Docker

docker build -t changethisfile-mcp .
docker run -i --rm -e CTF_API_KEY changethisfile-mcp

クイックテスト

curl -X POST https://changethisfile.com/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

対応形式

カテゴリ	例
画像	JPG、PNG、WebP、GIF、BMP、AVIF、ICO、SVG、TIFF、HEIC、PSD、RAW
動画	MP4、WebM、MKV、AVI、MOV、3GP、FLV、WMV
音声	MP3、WAV、FLAC、AAC、OGG、M4A、OPUS
ドキュメント	PDF、DOCX、DOC、ODT、RTF、TXT、HTML、MD、PPT、PPTX
データ	JSON、CSV、TSV、YAML、XML、TOML、XLSX、XLS
フォント	TTF、OTF、WOFF、WOFF2
電子書籍	EPUB、MOBI、AZW3、FB2、CBR、CBZ
アーカイブ	ZIP、RAR、7Z、TAR、TAR.GZ、TAR.BZ2、TAR.XZ

すべてのルート表については、list_conversions を使用してください。

環境変数

変数	デフォルト	用途
CTF_API_KEY	unset	任意の認証済み開発者キーをベアラートークンとして転送します。値がログに記録されることはありません
CTF_MCP_URL	https://changethisfile.com/mcp	上流エンドポイントを上書きします
CHANGETHISFILE_MCP_URL	unset	CTF_MCP_URL の旧式エイリアスです

プライバシーと制限

• ディスカバリーと有料プレビューのジョブにはアカウントは不要です。互換モードでは一般的な変換を一時的に匿名で利用できます。認証済みキーを使うと、共有の開発者向け使用量計測が適用されます。
• ファイルはサーバー側で処理され、24 時間以内に自動削除されます。ダウンロード URL の有効期限は 1 時間です。
• MCP の入力サイズ上限は 25 MB です。認証済みの convert_file では、開発者アカウントの共有 API／MCP レート制限と月間クォータが適用されます。その他の高負荷なツールには、アカウント単位または IP 単位の不正利用制限が引き続き適用されます。

ライセンス

MIT