Skip to main content
Glama
aadilr

ChangeThisFile MCP Server

by aadilr

ChangeThisFile MCPサーバー

任意のMCPクライアントからChangeThisFileの7つのファイルツールを利用できます:1,000以上の対応ルートにわたる変換、ドキュメント翻訳、テーブル抽出、正確なサイズ圧縮、自然言語ルーティング、ジョブステータス確認。

提供: ChangeThisFile.com。ディスカバリーおよび有料プレビューのジョブは公開されています。一般的な convert_file は現在、検証済みの開発者キーを受け付け、そのクォータをREST APIの使用量と共有します。匿名変換はコネクタ互換期間中は引き続き利用可能です。認証は2026年8月27日より前には強制されず、コネクタのサポートが確認された後にのみ強制されます。

ツール

ツール

説明

convert_file

ファイルを変換します。公開アクセス可能な source_url または base64_content(最大 ~5MB)と、target_format(例: pdfmp3json)を渡します。ソース形式は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を取得します。

Related MCP server: Omni File Converter MCP

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

サーバーは https://changethisfile.com/mcp でホストされており、ストリーミング可能なHTTPトランスポート(MCP仕様2025-03-26)を使用しています。クライアントがリモート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ダッシュボード から検証済みの無料キーを取得してください(または POST https://changethisfile.com/v1/keys/free{"email":"you@example.com"} を送信し、確認メールをクリックします)。その月25回の変換はMCPとRESTで共有されます。有料プランは月額$29からです。

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

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

オプション3 — Agent Skill / Claude Codeプラグイン

このリポジトリは Agent Skill と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ツールを優先し、それ以外の場合は、ホスト型エンドポイントとプレーンなHTTPSで通信するバンドルスクリプト(skills/file-conversion/scripts/convert.sh)にフォールバックします — MCPクライアントは不要です。

オプション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

未設定

オプションの検証済み開発者キー。ベアラートークンとして転送されます。値がログに記録されることはありません

CTF_MCP_URL

https://changethisfile.com/mcp

アップストリームエンドポイントを上書きします

CHANGETHISFILE_MCP_URL

未設定

CTF_MCP_URL のレガシーエイリアス

プライバシーと制限

  • ディスカバリーおよび有料プレビューのジョブはアカウントを必要としません。一般的な変換は互換モードでは一時的に匿名です。検証済みキーを使用すると、共有開発者メータリングが今すぐ有効になります。

  • ファイルはサーバー側で処理され、24時間以内に自動削除されます。ダウンロードURLは1時間後に期限切れになります。

  • MCP入力は25MBに制限されています。認証済みの convert_file は開発者アカウントの共有API/MCPレートと月間クォータを使用します。その他の負荷の高いツールには、アカウント単位またはIP単位の不正使用制限が維持されます。

ライセンス

MIT

Available Tools

2 tools
convert_fileConvert FileAInspect

Convert a file from one format to another. Pass EITHER a publicly accessible URL (source_url) OR base64-encoded file contents (base64_content + source_format) — exactly one is required. Returns a temporary download URL (valid 1 hour; file deleted within 24 hours).

ParametersJSON Schema
NameRequiredDescriptionDefault
source_urlNoPublicly accessible URL of the file to convert (preferred for large files)
base64_contentNoBase64-encoded file content (for small files; max ~5MB)
source_formatNoSource format extension (e.g. "docx", "mp4"). Auto-detected from URL if omitted.
target_formatYesTarget format extension (e.g. "json", "mp3", "pdf"). Required.
filenameNoOptional filename hint for auto-detection (e.g. "document.docx")

TDQS

A4.5/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

The description discloses key behavioral details: returns a temporary download URL (valid 1 hour) and that the file is deleted within 24 hours. These details are beyond what annotations provide (readOnlyHint=false, destructiveHint=false) and give the agent important lifecycle information. No contradiction with annotations exists.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is concise at 3 sentences, each serving a distinct purpose: stating the core action, specifying parameter rules, and detailing the return behavior. No extraneous information is included, making it easy for an agent to parse quickly.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given no output schema, the description adequately explains the return format (temporary URL with expiry) and data retention. It covers all input modalities and constraints. The presence of sibling tool name provides context. The description is complete for a conversion tool of moderate complexity.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema already describes all 5 parameters (100% coverage), setting baseline at 3. The description adds semantic value by explaining the mutual exclusivity of source_url and base64_content, specifying the ~5MB limit for base64, and noting that source_format can be auto-detected. This enhances the agent's understanding beyond the schema's per-parameter descriptions.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description begins with a clear verb-resource pair: 'Convert a file from one format to another.' This immediately identifies the tool's core function. It also distinguishes itself from the sibling tool 'list_conversions' by focusing on performing the conversion rather than listing available formats.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description explicitly states the two mutually exclusive input methods (url vs base64) and clarifies that exactly one is required. It provides guidance on when to prefer each (URL for large files, base64 for small files) and mentions auto-detection of source format. However, it does not explicitly state when not to use this tool or compare it to alternatives beyond the sibling.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

list_conversionsList Supported ConversionsA
Read-only
Inspect

List all supported conversion routes. Optionally filter by source format to see what you can convert FROM a specific format.

ParametersJSON Schema
NameRequiredDescriptionDefault
source_formatNoFilter by source format (e.g. "docx" returns all DOCX target options)

TDQS

A4.3/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint=true, so the description need not restate safety. The description adds the filtering behavior, which is useful but not extensive behavioral context.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences efficiently communicate the purpose and optional filter, with zero unnecessary words. Front-loaded with the main action.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple tool with one optional parameter and no output schema, the description fully covers what the agent needs to know: what it lists and how to filter.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% with the parameter already described, but the description adds meaning by explaining the filter effect and providing an example ('docx' returns all DOCX target options), enhancing understandability.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the verb 'list' and resource 'supported conversion routes', and implicitly distinguishes from sibling 'convert_file' by indicating this tool provides options for conversion rather than performing the conversion.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It specifies when to use the tool (to list conversion routes, optionally filtered by source format) and gives a concrete example. However, it does not explicitly state when not to use it or mention alternatives beyond the sibling.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. 2 tool updatesv1.0.0
    • First observedconvert_file
    • First observedlist_conversions

TDQS

A4.3/5.0
Disambiguation5/5

The two tools have clearly distinct purposes: one performs file conversions, the other lists supported conversion routes. No overlap exists.

Naming Consistency5/5

Both tools follow a consistent verb_noun pattern (convert_file, list_conversions) using snake_case, making naming predictable.

Tool Count3/5

With only 2 tools, the server feels minimal for a file conversion service. While covering the core functionality, the low count suggests a thin surface.

Completeness3/5

The server covers basic conversion and format discovery, but lacks features like conversion history, batch processing, or progress tracking, leaving notable gaps.

Maintenance

ActivityMaintained
ResponsivenessUnresponsive

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/aadilr/changethisfile-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server