conversiontools

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

ConversionTools File Conversion

ConversionTools 文件转换

Convert files between 140+ formats directly from your agent using the ConversionTools MCP server.

借助ConversionTools MCP服务器，可直接通过你的Agent在140余种格式之间转换文件。

Setup

配置步骤

If the ConversionTools MCP server is already connected, skip to Available Tools.

If the MCP server is not connected, add it:

bash

claude mcp add --transport http conversiontools https://mcp.conversiontools.io/mcp

Restart Claude Code after adding the server. MCP server changes require a restart to take effect.

On first use, you will be prompted to authenticate via OAuth in your browser. Free accounts get 100 conversions per month (10 per day). Paid plans available at conversiontools.io/pricing.

如果ConversionTools MCP服务器已连接，请跳至可用工具部分。

若未连接MCP服务器，请添加：

bash

claude mcp add --transport http conversiontools https://mcp.conversiontools.io/mcp

添加服务器后重启Claude Code。MCP服务器的更改需重启才能生效。

首次使用时，系统会提示你在浏览器中通过OAuth进行身份验证。免费账户每月可进行100次转换（每天10次）。付费方案详情请访问conversiontools.io/pricing。

Available Tools

可用工具

All tools use the

conversiontools

MCP server prefix:

conversiontools:tool_name

所有工具均使用

conversiontools

作为MCP服务器前缀：

conversiontools:tool_name

。

conversiontools:convert_file

— Convert a file

conversiontools:convert_file

— 文件转换

The primary tool. Provide input and output paths — the converter is auto-detected from file extensions.

Parameters:

```
input_path
```
(required): Path to the input file
```
output_path
```
(required): Path for the converted output file
```
file_content
```
(optional): Base64-encoded file content for files up to 5MB

file_id

(optional): File ID from a previous

conversiontools:request_upload_url

call

```
converter
```
(optional): Explicit converter type like
```
convert.pdf_to_excel
```
. Auto-detected if omitted.
```
options
```
(optional): Converter-specific options

核心工具。提供输入和输出路径，转换器会根据文件扩展名自动检测。

参数：

```
input_path
```
（必填）：输入文件的路径
```
output_path
```
（必填）：转换后输出文件的路径
```
file_content
```
（可选）：最大5MB文件的Base64编码内容
```
file_id
```
（可选）：之前调用
```
conversiontools:request_upload_url
```
返回的文件ID
```
converter
```
（可选）：明确的转换器类型，如
```
convert.pdf_to_excel
```
。若省略则自动检测。
```
options
```
（可选）：转换器专属配置项

conversiontools:request_upload_url

— Upload large files

conversiontools:request_upload_url

— 大文件上传

Get a signed URL for uploading files larger than 5MB.

Parameters:

```
filename
```
(required): Name of the file to upload

Flow for large files:

Call
```
conversiontools:request_upload_url
```
with the filename
Upload file to the returned URL using PUT
Call
```
conversiontools:convert_file
```
with the returned
```
file_id
```

获取用于上传大于5MB文件的签名URL。

参数：

```
filename
```
（必填）：待上传文件的名称

大文件处理流程：

调用
```
conversiontools:request_upload_url
```
并传入文件名
使用PUT方法将文件上传至返回的URL
调用
```
conversiontools:convert_file
```
并传入返回的
```
file_id
```

conversiontools:list_converters

— Browse available converters

conversiontools:list_converters

— 浏览可用转换器

Use this to discover what conversions are currently supported. New converters are added regularly — always check here for the latest.

Parameters:

category

(optional):

documents

data

images

pdf

audio

video

ebook

ocr

ai

subtitles

web

```
input_format
```
(optional): Filter by input format, e.g.
```
pdf
```
```
output_format
```
(optional): Filter by output format, e.g.
```
csv
```

用于查看当前支持的转换类型。转换器会定期更新，请始终在此查看最新支持的类型。

参数：

category

（可选）：

documents

、

data

、

images

、

pdf

、

audio

、

video

、

ebook

、

ocr

、

ai

、

subtitles

、

web

```
input_format
```
（可选）：按输入格式筛选，例如
```
pdf
```
```
output_format
```
（可选）：按输出格式筛选，例如
```
csv
```

conversiontools:find_converter

— Find the right converter

conversiontools:find_converter

— 查找合适的转换器

Parameters:

```
input_format
```
(required): e.g.
```
pdf
```
```
output_format
```
(required): e.g.
```
excel
```

参数：

```
input_format
```
（必填）：例如
```
pdf
```
```
output_format
```
（必填）：例如
```
excel
```

conversiontools:get_converter_info

— Get converter details

conversiontools:get_converter_info

— 获取转换器详情

Parameters:

```
converter
```
(required): Converter type, e.g.
```
convert.pdf_to_excel
```

参数：

```
converter
```
（必填）：转换器类型，例如
```
convert.pdf_to_excel
```

conversiontools:auth_status

— Check login status

conversiontools:auth_status

— 检查登录状态

conversiontools:auth_login

— Trigger OAuth login

conversiontools:auth_login

— 触发OAuth登录

conversiontools:auth_logout

— Clear credentials

conversiontools:auth_logout

— 清除凭证

How to Convert Files

文件转换方法

You must provide the file content — the server cannot read local paths. Choose the method based on file size. The response includes a

download_url

— download the result with curl.

你必须提供文件内容——服务器无法读取本地路径。根据文件大小选择合适的方法。响应结果包含

download_url

——可使用curl下载转换结果。

Small files (up to 5MB)

小文件（最大5MB）

Base64-encode the file

Call

conversiontools:convert_file

with

file_content

input_path

, and

output_path

Download the result from the returned
```
download_url
```

bash

undefined

对文件进行Base64编码

调用

conversiontools:convert_file

并传入

file_content

、

input_path

和

output_path

从返回的
```
download_url
```
下载转换结果

bash

undefined

1. Encode

1. 编码

base64_content=$(base64 -w 0 data.json)

undefined

base64_content=$(base64 -w 0 data.json)

undefined

2. Convert

2. 转换

conversiontools:convert_file({ input_path: "data.json", output_path: "data.csv", file_content: "<base64_content>" })


```bash

conversiontools:convert_file({ input_path: "data.json", output_path: "data.csv", file_content: "<base64_content>" })


```bash

3. Download

3. 下载

curl -sL "<download_url>" -o data.csv

undefined

curl -sL "<download_url>" -o data.csv

undefined

Large files (over 5MB)

大文件（超过5MB）

Call
```
conversiontools:request_upload_url
```
with the filename to get a signed upload URL and
```
file_id
```
Upload the file to the returned URL with
```
curl -X PUT
```

Call

conversiontools:convert_file

with the

file_id

instead of

file_content

Download the result from the returned
```
download_url
```

调用
```
conversiontools:request_upload_url
```
并传入文件名，获取签名上传URL和
```
file_id
```
使用
```
curl -X PUT
```
将文件上传至返回的URL

调用

conversiontools:convert_file

并传入

file_id

而非

file_content

从返回的
```
download_url
```
下载转换结果

Supported Categories

支持的分类

The following categories are available. Use

conversiontools:list_converters

with a

category

input_format

, or

output_format

filter to discover specific converters — new formats are added regularly.

Documents — Word (DOCX, DOC), PowerPoint (PPTX, PPT), Excel (XLSX, XLS), Markdown, ODS, HTML, Text, LaTeX
PDF — Convert to/from Word, Excel, CSV, Text, HTML, Images (JPG, PNG, SVG, TIFF), EPUB
Data Formats — JSON, CSV, XML, YAML, Parquet, JSONL, BSON, Excel — with validators and formatters
Images — PNG, JPG, WebP, AVIF, HEIC, JXL (JPEG XL), SVG, BMP, TIFF, GIF, PGM, PPM — plus EXIF removal
Audio — MP3, WAV, FLAC — plus AI text-to-speech (Text/DOCX/PDF/Markdown to MP3) and AI speech-to-text transcription (MP3/WAV/FLAC to Text)
Video — MP4, MOV, MKV, AVI — plus audio extraction (MP4 to MP3)
E-books — EPUB, MOBI, AZW, AZW3, FB2, FBZ, PDF
OCR — Extract text from scanned PDFs and images (JPG, PNG) — output as Text or searchable PDF
AI-Powered — Smart extraction from PDFs and images to JSON, CSV, Excel, Markdown — plus AI subtitle translation, text-to-speech (TTS), and speech-to-text (STT)
Subtitles — SRT, VTT, ASS, CSV, Excel, Text — bidirectional conversions
Web — Website screenshots (URL to PDF, JPG, PNG), HTML to images/Word, HTML table extraction

以下是支持的分类。使用

conversiontools:list_converters

并结合

category

、

input_format

或

output_format

筛选器可查看具体转换器——新格式会定期添加。

文档——Word（DOCX、DOC）、PowerPoint（PPTX、PPT）、Excel（XLSX、XLS）、Markdown、ODS、HTML、文本、LaTeX
PDF——与Word、Excel、CSV、文本、HTML、图片（JPG、PNG、SVG、TIFF）、EPUB之间的互转
数据格式——JSON、CSV、XML、YAML、Parquet、JSONL、BSON、Excel——包含验证器和格式化工具
图片——PNG、JPG、WebP、AVIF、HEIC、JXL（JPEG XL）、SVG、BMP、TIFF、GIF、PGM、PPM——支持移除EXIF信息
音频——MP3、WAV、FLAC——支持AI文本转语音（文本/DOCX/PDF/Markdown转MP3）和AI语音转文本转录（MP3/WAV/FLAC转文本）
视频——MP4、MOV、MKV、AVI——支持提取音频（MP4转MP3）
电子书——EPUB、MOBI、AZW、AZW3、FB2、FBZ、PDF
OCR——从扫描版PDF和图片（JPG、PNG）中提取文本——输出为文本或可搜索PDF
AI驱动——从PDF和图片中智能提取结构化数据并转换为JSON、CSV、Excel、Markdown——支持AI字幕翻译、文本转语音（TTS）和语音转文本（STT）
字幕——SRT、VTT、ASS、CSV、Excel、文本——双向转换
网页——网站截图（URL转PDF、JPG、PNG）、HTML转图片/Word、HTML表格提取

Discovering Converters

查找转换器

When unsure if a specific conversion is supported, use the discovery tools rather than guessing:

undefined

不确定是否支持特定转换时，请使用查找工具而非猜测：

undefined

Check what PDF can convert to

查看PDF可转换为哪些格式

conversiontools:list_converters({ input_format: "pdf" })

Check what can produce Parquet

查看哪些格式可转换为Parquet

conversiontools:list_converters({ output_format: "parquet" })

Browse all data converters

浏览所有数据转换器

conversiontools:list_converters({ category: "data" })

Find the right converter for a specific pair

查找特定格式对的转换器

conversiontools:find_converter({ input_format: "xlsx", output_format: "parquet" })

Get full details and options for a converter

获取转换器的完整详情和配置项

conversiontools:get_converter_info({ converter: "convert.csv_to_parquet" })

undefined

conversiontools:get_converter_info({ converter: "convert.csv_to_parquet" })

undefined

Tips

小贴士

Auto-detection works well — just provide file paths with correct extensions and skip the
```
converter
```
parameter
Use
```
conversiontools:list_converters
```
with filters when unsure what's available
AI converters (
```
convert.ai_pdf_to_json
```
, etc.) use AI to intelligently extract structured data from complex documents — use these when standard converters produce poor results
OCR converters are for scanned documents and images containing text — use when the source is an image or non-searchable PDF
For batch conversions, upload a ZIP, 7z, XZ, or RAR archive containing all files — they will all be converted and returned as a
```
.result.zip
```
file. Alternatively, call
```
conversiontools:convert_file
```
once per file.

自动检测功能表现良好——只需提供带有正确扩展名的文件路径，无需指定
```
converter
```
参数
不确定支持哪些转换时，使用带筛选器的
```
conversiontools:list_converters
```
AI转换器（如
```
convert.ai_pdf_to_json
```
等）使用AI从复杂文档中智能提取结构化数据——当标准转换器效果不佳时使用这些工具
OCR转换器适用于扫描文档和含文本的图片——当源文件是图片或不可搜索的PDF时使用
批量转换时，上传包含所有文件的ZIP、7z、XZ或RAR压缩包——所有文件都会被转换并以
```
.result.zip
```
文件返回。或者，对每个文件单独调用
```
conversiontools:convert_file
```
。