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

ChangeThisFile MCP 服务

在任何 MCP 客户端中使用 ChangeThisFile 的七种文件工具：支持 1,000 多种格式转换、文档翻译、表格提取、精确大小压缩、自然语言路由和作业状态检查。

由 ChangeThisFile.com 提供支持。发现和付费预览作业均为公开作业。通用的 convert_file 每个网络每月可免费使用 25 次，无需密钥；超过此限额后，需要免费的已验证开发者密钥（每月 25 次转换，与 REST API 共享），付费 API 计划可提高限额。

工具

工具	说明
convert_file	转换文件。传入公开可访问的 source_url 或 base64_content（最大约 5 MB），以及 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、图像或视频压缩到指定的最大大小。每日限额内免费。
do_file_job	将自然语言文件指令路由到转换、翻译、提取或压缩操作。
check_job	检查已提交的作业，并获取其预览、结账链接或下载 URL。

选项 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 控制面板获取免费的已验证密钥（或者向 https://changethisfile.com/v1/keys/free 发送 POST 请求，并附上 {"email":"[email protected]"}，然后点击验证邮件中的链接）；每月 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 插件。

任何支持技能的 Agent（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），通过普通 HTTPS 与托管端点通信——无需 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	未设置	可选的已验证开发者密钥，会作为 bearer token 转发；其值绝不会记录到日志中
CTF_MCP_URL	https://changethisfile.com/mcp	覆盖上游端点
CHANGETHISFILE_MCP_URL	未设置	CTF_MCP_URL 的旧版别名

隐私与限制

• 发现和付费预览任务无需账户。兼容模式下，通用转换暂时无需身份验证；已验证的密钥目前可启用开发者共享用量统计。
• 文件在服务器端处理，并会在 24 小时内自动删除；下载 URL 会在 1 小时后过期。
• MCP 输入大小上限为 25 MB。经过身份验证的 convert_file 使用开发者账户共享的 API/MCP 速率限制和月度配额；其他高开销工具仍受每个账户或每个 IP 的滥用限制。

许可证

MIT