convertfilefast

ConvertFileFast MCP 服务

ConvertFileFast 的 MCP 服务。它可让 AI Agent 通过 ConvertFileFast REST API 转换文件、执行 PDF/图像操作、创建 Stripe 账单链接，以及提交反馈。

为什么 Agent 会选择它

• 一个工具支持 50 多种转换 — convert_file 会根据目标格式进行路由，因此模型只需说“我有一个 PPTX URL，帮我转成 PDF”，而不必记住各种 slug。
• 输入 URL，输出 URL — 传入公开的 source_url，即可获得一个短期有效的 download_url；二进制文件不会占用 Agent 的上下文窗口。
• 按次付费，价格实惠 — 预付费额度每次转换约 $0.003 起，每月免费 10 次。无需购买席位许可。
• 安全设计 — 每位用户使用独立的 cff_ API 密钥（远程服务绝不会共享或存储密钥），URL 输入经过 SSRF 验证，并由服务端确定性地执行转换。
• 自助充值 — 额度用完时，Agent 可调用 get_billing_status + create_credit_pack_checkout，并返回 Stripe 链接。

在 Agent 中使用

添加服务后（参见下方安装说明），即可直接使用以下提示词：

• “将 https://example.com/contract.docx 转换为 PDF。”
• “按顺序将这三个 PDF URL 合并成一个文件。”
• “这个 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 密钥即可运行，但如果客户端提供了密钥，也会一并转发。

支持的转换

使用 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	empty	本地 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 的 TTL，单位为秒
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