Converteverything MCP

ConvertEverything MCP服务器

MCP（模型上下文协议）服务器，使Claude等AI助手能够使用 转换Everything.io API

“嘿，克劳德，把这个HEIC转换成JPG” --就这么简单。

为什么要转换一切？

厌倦了带有弹出式广告和“高级”追加销售的粗略转换器网站？我们建造 转换Everything.io 对于想要：

• 没有广告，没有废话 --简洁的界面，快速转换
• 实际上是免费套餐 --每天20次转换，免费账户，无需信用卡
• 严重的文件大小限制 --每个文件高达10GB（请尝试在其他地方找到）
• 隐私第一 --文件自动删除，无数据挖掘
• API访问 --因为您正在阅读MCP README，所以您可能想要这个

特性

• 100+支持的格式：音频、视频、图像（包括RAW相机格式）、文档、电子书、数据、3D、字体、存档和CAD文件
• 文件压缩：使用质量预设压缩图像、视频和PDF
• 档案创建：从多个文件创建ZIP、TAR、7z存档
• 文件共享：生成可共享链接并通过电子邮件发送文件
• 云导入：从Google Drive、Dropbox、OneDrive和Box导入文件
• 简单集成：适用于Claude Desktop、Claude Code和任何兼容MCP的客户端
• 转换选项：微调输出质量、分辨率、比特率等
• 安全：使用您的个人API密钥，除了转换处理之外，没有存储在第三方服务器上的数据

热门转换

以下是人们实际使用它的原因：

浏览全部 音频转换器, 视频转换器, 图像转换器，以及 文档转换器.

支持格式

需求

• Node.js 18或更高版本
• ConvertEverything.io API密钥- 所有注册用户100%免费！

- 免费账户：5个API呼叫/天 - 铜奖（5.99美元/月）：每天200个API电话 - 白银（9.99美元/月）：每天400个API电话 - 黄金（24.99美元/月）：无限制API调用

文件保留期

转换后的文件被临时存储。使用 retention_hours 控制文件保存时间的参数：

如果未指定，默认保留时间为24小时。

安装

来自npm（推荐）

npm install -g converteverything-mcp

来源

git clone https://github.com/converteverything/converteverything-mcp.git
cd converteverything-mcp
npm install
npm run build

配置

1.获取API密钥

1. 注册于 转换一切.io （免费）
2. 首选 API密钥 并创建新密钥
3. 复制密钥（以开头 ce_)

API访问是100%免费的！ 所有注册用户都可以访问API。免费套餐：每天5次通话。 升级 更多。

2.客户端配置

Claude Desktop

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "converteverything": {
      "command": "npx",
      "args": ["-y", "converteverything-mcp", "--api-key", "ce_your_api_key_here"]
    }
  }
}

Claude Code (Anthropic CLI)

添加 ~/.claude/settings.json:

{
  "mcpServers": {
    "converteverything": {
      "command": "npx",
      "args": ["-y", "converteverything-mcp", "--api-key", "ce_your_api_key_here"]
    }
  }
}

或者通过CLI添加：

claude mcp add converteverything -- npx -y converteverything-mcp --api-key ce_your_key

Cursor IDE

添加到光标设置(~/.cursor/mcp.json):

{
  "mcpServers": {
    "converteverything": {
      "command": "npx",
      "args": ["-y", "converteverything-mcp", "--api-key", "ce_your_api_key_here"]
    }
  }
}

Windsurf (Codeium)

添加 ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "converteverything": {
      "command": "npx",
      "args": ["-y", "converteverything-mcp", "--api-key", "ce_your_api_key_here"]
    }
  }
}

Cline (VS Code Extension)

在VS Code中打开Cline设置并添加到MCP服务器：

{
  "converteverything": {
    "command": "npx",
    "args": ["-y", "converteverything-mcp", "--api-key", "ce_your_api_key_here"]
  }
}

Zed Editor

添加 ~/.config/zed/settings.json:

{
  "context_servers": {
    "converteverything": {
      "command": {
        "path": "npx",
        "args": ["-y", "converteverything-mcp", "--api-key", "ce_your_api_key_here"]
      }
    }
  }
}

Continue.dev

添加 ~/.continue/config.json:

{
  "experimental": {
    "modelContextProtocolServers": [
      {
        "transport": {
          "type": "stdio",
          "command": "npx",
          "args": ["-y", "converteverything-mcp", "--api-key", "ce_your_api_key_here"]
        }
      }
    ]
  }
}

Manual / Generic Usage

直接从命令行运行：

# With API key as argument
npx converteverything-mcp --api-key ce_your_key

# With environment variable
export CONVERTEVERYTHING_API_KEY=ce_your_key
npx converteverything-mcp

# Short form
npx converteverything-mcp -k ce_your_key

对于基于stdio的集成，服务器使用MCP协议通过stdin/stdout进行通信。

备选方案：环境变量

所有客户端还支持通过环境变量传递API密钥：

{
  "mcpServers": {
    "converteverything": {
      "command": "npx",
      "args": ["-y", "converteverything-mcp"],
      "env": {
        "CONVERTEVERYTHING_API_KEY": "ce_your_api_key_here"
      }
    }
  }
}

CLI选项

可用工具

get_supported_formats

获取按类别组织的所有支持文件格式的列表。

User: What formats can you convert?
Claude: [Uses get_supported_formats] I can convert between 93+ formats including...

get_usage

检查您当前的API使用情况和限制。

User: How many conversions do I have left today?
Claude: [Uses get_usage] You've used 5 of your 100 daily conversions...

convert_file

将文件从一种格式转换为另一种格式。

User: Convert my-video.mov to mp4
Claude: [Uses convert_file] Starting conversion...

参数：

• file_path （必需）：要转换的文件的路径
• target_format （必填）：目标格式（例如“mp3”、“pdf”、“png”）
• options （可选）：转换设置（见下文）

convert_base64

转换作为base64数据提供的文件。

参数：

• data （必需）：Base64编码文件数据
• filename （必填）：带扩展名的原始文件名
• target_format （必填）：目标格式
• options （可选）：转换设置

get_conversion_status

检查正在进行的转换的状态。

User: Is my conversion done yet?
Claude: [Uses get_conversion_status] Your conversion is complete and ready to download!

download_file

下载已完成的转换。

参数：

• conversion_id （必填）：转换ID
• save_path （可选）：保存文件的路径

list_presets

获取可用的转换预设，以便快速配置。

User: What presets are available?
Claude: [Uses list_presets] Here are the available presets:
- web-optimized: Smaller files, fast loading
- high-quality: Best quality, larger files
- balanced: Good quality with reasonable size
...

batch_convert

一次转换多个文件。

User: Convert all the WAV files in my project to MP3
Claude: [Uses batch_convert] Converting 5 files to MP3...

参数：

• file_paths （必需）：要转换的文件路径数组
• target_format （必填）：所有文件的目标格式
• preset （可选）：使用预设（例如“网络优化”）
• options （可选）：转换设置

wait_for_conversion

等待转换完成，并进行进度轮询。

User: Convert this large video and let me know when it's done
Claude: [Uses convert_file, then wait_for_conversion] The conversion is now complete!

参数：

• conversion_id （必填）：要等待的转换ID
• poll_interval （可选）：状态检查之间的毫秒数（默认值：2000）
• timeout （可选）：最大等待时间（毫秒）（默认值：300000）

list_conversions

按页码列出您最近的转换。

User: Show me my recent conversions
Claude: [Uses list_conversions] Here are your last 10 conversions...

参数：

• page （可选）：页码（默认：1）
• per_page （可选）：每页结果，1-100（默认值：10）

cancel_conversion

删除转换及其关联文件。注意：无法取消正在进行的转换。

User: Delete that failed conversion
Claude: [Uses cancel_conversion] Conversion deleted successfully.

参数：

• conversion_id （必填）：要删除的转换ID

get_file_info

在转换之前获取文件元数据（大小、格式、MIME类型）。

User: What's the size of this video file?
Claude: [Uses get_file_info] The file is 1.2 GB, format: MP4, MIME: video/mp4

参数：

• file_path （必填）：要分析的文件的路径

estimate_output_size

转换前估计输出文件大小。

User: How big will this WAV be as MP3?
Claude: [Uses estimate_output_size] Estimated output: ~15 MB (from 150 MB WAV at 128k bitrate)

参数：

• file_path （必需）：源文件的路径
• target_format （必填）：目标格式
• options （可选）：影响大小的转换选项
• preset （可选）：预设名称

______________________________________________________________________

压缩工具

compress_image

压缩图像文件以减小文件大小。

User: Compress this photo to make it smaller for email
Claude: [Uses compress_image] Compressed from 5.2 MB to 1.1 MB (79% reduction)

参数：

• file_path （必填）：图像文件的路径
• quality （可选）：质量级别1-100（默认值：80）
• max_dimension （可选）：最大宽度/高度（像素）
• retention_hours （可选）：文件保留期1-720小时（默认值：24，基于级别的最大值）

compress_video

压缩视频文件以减小文件大小。

User: Make this video smaller for uploading
Claude: [Uses compress_video] Compressed from 500 MB to 85 MB

参数：

• file_path （必填）：视频文件的路径
• crf （可选）：质量0-51，越低越好（默认值：28）
• preset （可选）：速度预设（超快、快、中、慢）
• max_resolution （可选）：最大分辨率（例如，“1920x1080”、“720p”）
• remove_audio （可选）：删除音轨
• retention_hours （可选）：文件保留期1-720小时（默认值：24，基于级别的最大值）

compress_pdf

压缩PDF文件以减小文件大小。

User: This PDF is too large to email, can you compress it?
Claude: [Uses compress_pdf] Compressed from 25 MB to 3.2 MB

参数：

• file_path （必填）：PDF文件的路径
• quality （可选）：压缩质量：低、中、高（默认值：中等）
• retention_hours （可选）：文件保留期1-720小时（默认值：24，基于级别的最大值）

get_compression_usage

检查您的压缩使用情况和限制。

User: How many compressions do I have left?
Claude: [Uses get_compression_usage] You've used 15 of 100 compressions today

______________________________________________________________________

存档工具

create_archive

从多个文件创建存档。

User: Zip up all these project files
Claude: [Uses create_archive] Created project.zip with 12 files (45 MB)

参数：

• file_paths （必需）：要包含的文件路径数组
• output_format （可选）：zip、tar、tar.gz、tar.bz2或7z（默认：zip）
• archive_name （可选）：存档的自定义名称
• compression_level （可选）：1-9（默认值：6）
• retention_hours （可选）：文件保留期1-720小时（默认值：24，基于级别的最大值）

______________________________________________________________________

高级转换工具

reconvert

使用不同的设置重新运行之前的转换。

User: Can you redo that last conversion but with higher quality?
Claude: [Uses reconvert] Re-converting with quality set to 95...

参数：

• conversion_id （必填）：上次转换的ID
• target_format （可选）：新目标格式
• options （可选）：新的转换选项

get_thumbnail

获取转换的缩略图预览。

User: Show me a preview of that converted image
Claude: [Uses get_thumbnail] Here's a thumbnail preview...

参数：

• conversion_id （必填）：转换ID
• save_path （可选）：保存缩略图的路径

batch_convert_api

使用API的批处理端点进行真正的批处理转换（对于大批量更有效）。

User: Convert all 50 of these files to PDF
Claude: [Uses batch_convert_api] Batch started with ID batch_abc123...

参数：

• file_paths （必需）：文件路径数组
• target_format （必填）：所有文件的目标格式
• options （可选）：转换选项

get_batch_status

检查批处理转换的状态。

User: How's that batch conversion going?
Claude: [Uses get_batch_status] 45 of 50 complete, 5 still processing...

参数：

• batch_id （必填）：批次ID

______________________________________________________________________

文件共享工具

list_my_files

列出您的可共享文件。

User: What files do I have available to share?
Claude: [Uses list_my_files] You have 5 files ready to share...

参数：

• page （可选）：页码（默认：1）
• per_page （可选）：每页结果（默认值：20）

create_share_link

为文件创建可共享的下载链接。

User: Generate a link I can share for that converted video
Claude: [Uses create_share_link] Here's your shareable link: https://converteverything.io/s/abc123

参数：

• conversion_id （必填）：转换ID
• expires_hours （可选）：链接到期前的小时数（默认值：24）

share_via_email

直接通过电子邮件共享文件。

User: Email that PDF to john@example.com
Claude: [Uses share_via_email] Email sent to john@example.com with download link

参数：

• conversion_id （必填）：转换ID
• recipient_email （必填）：要发送的电子邮件地址
• message （可选）：要包含的自定义消息

______________________________________________________________________

云导入工具

list_cloud_providers

列出可用的云存储提供商。

User: What cloud services can I import from?
Claude: [Uses list_cloud_providers] You can import from Google Drive, Dropbox, OneDrive, and Box

list_cloud_connections

列出您连接的云存储帐户。

User: What cloud accounts do I have connected?
Claude: [Uses list_cloud_connections] You have Google Drive (user@gmail.com) connected

list_cloud_files

浏览连接的云存储帐户中的文件。

User: Show me the files in my Google Drive
Claude: [Uses list_cloud_files] Here are your Google Drive files...

参数：

• connection_id （必填）：云连接ID
• folder_id （可选）：要浏览的文件夹（如果未指定，则为root）
• page_token （可选）：用于分页

import_from_cloud

从云存储导入文件进行转换。

User: Import that video from my Dropbox and convert it to MP4
Claude: [Uses import_from_cloud, then convert_file] Importing and converting...

参数：

• connection_id （必填）：云连接ID
• file_id （必填）：云文件ID
• target_format （可选）：导入后立即转换
• options （可选）：转换选项（如果转换）

______________________________________________________________________

转换预设

预设提供针对不同用例优化的预配置转换设置。使用它们与 preset 参数在 convert_file, convert_base64，或 batch_convert.

预设示例

User: Convert my podcast.wav to MP3 for web
Claude: [Uses convert_file with preset: "web-optimized"]
Converting with web-optimized settings (128kbps, 44.1kHz stereo)...

User: Convert these photos for print
Claude: [Uses batch_convert with preset: "print-ready"]
Converting with print-ready settings (300 DPI, maximum quality)...

转换选项

音频选项

非常适合 MP3转换、播客和音乐：

{
  "bitrate": "320k",
  "sample_rate": 48000,
  "channels": 2,
  "normalize": true
}

视频选项

对于 视频格式转换流媒体和社交媒体：

{
  "resolution": "1920x1080",
  "fps": 30,
  "crf": 23,
  "preset": "medium",
  "audio_bitrate": "192k",
  "remove_audio": false
}

图像选项

对于 图像转换、网络优化和打印：

{
  "quality": 90,
  "max_dimension": 2048,
  "strip_metadata": true,
  "dpi": 300
}

文档选项

对于 PDF转换 办公文件：

{
  "pdf_quality": "printer",
  "page_size": "a4",
  "orientation": "portrait"
}

MCP资源

服务器将格式文档作为MCP资源公开，AI助手可以阅读这些文档来理解支持的格式。

资源允许人工智能助手在不调用API的情况下获得有关支持格式的上下文知识。

MCP提示

常见转换任务的预构建提示：

对话示例

转换图像

User: Convert screenshot.png to a high-quality JPEG
Claude: I'll convert that PNG to JPEG for you with high quality settings.
[Uses convert_file with options: {"quality": 95}]
The conversion is complete! Your file has been converted to JPEG.

转换视频

User: I need to convert this MOV file to MP4 for web use
Claude: I'll convert your MOV to MP4 with web-optimized settings.
[Uses convert_file with options: {"crf": 23, "preset": "medium"}]
Done! The MP4 is ready for download.

批量转换

User: Convert all the screenshots in ~/Desktop to JPG for the web
Claude: [Uses batch_convert with preset: "web-optimized"]
Converting 12 PNG files to JPG with web-optimized settings...
All 12 conversions started. I'll monitor their progress.
[Uses wait_for_conversion for each]
All done! 12 files converted successfully.

检查转换历史记录

User: What did I convert recently?
Claude: [Uses list_conversions]
Here are your last 10 conversions:
1. report.pdf → docx (completed, 2 hours ago)
2. video.mov → mp4 (completed, yesterday)
...

格式查询

User: What video formats can I convert to?
Claude: [Uses get_supported_formats]
You can convert to these video formats: mp4, avi, mkv, mov, webm, wmv, flv, m4v, 3gp, ts, vob, mts, mpeg, m2ts, divx

大文件处理

从2.1.0版本开始，MCP服务器使用以下命令自动处理大型文件 分块上传:

• 大于30MB的文件 自动拆分为10MB的块
• 并行上传 （3个并发），传输速度更快
• 更高的可靠性 -可以重试失败的块，而无需重新启动整个上传
• 内存效率高 -一次只能将一个块加载到内存中

这对用户来说是透明的——只需使用 convert_file 正常情况下，其余部分由服务器处理。

User: Convert my 500MB video to MP4
Claude: [Uses convert_file - automatically uses chunked upload for large files]
Starting conversion... (uploading in 50 chunks)

安全

此MCP服务器：

• 仅使用公共ConvertEverything.io API
• 需要您的个人API密钥（从不共享）
• 验证所有文件路径以防止目录遍历
• 上传前对文件名进行消毒
• 对所有API通信使用HTTPS
• 不存储任何文件或凭据
• 对大文件（>30MB）使用分块上传以提高可靠性

您的文件是：

• 传输中加密（HTTPS/TLS）
• 在ConvertEverything.io服务器上处理
• 在您的层保留期（6小时至60天）后自动删除

故障排除

“需要API密钥”

确保您已设置 CONVERTEVERYTHING_API_KEY MCP配置中的环境变量。

“API密钥格式无效”

API密钥必须以开头 ce_。从以下位置获取钥匙 转换一切.io/api-keys.

“不支持的格式”

使用 get_supported_formats 查看所有可用格式。某些格式组合可能不受支持。

“超出每日限额”

您的订阅层有每日转换限制。 升级到黄金 无限制转换。

定价

所有注册用户都可以访问API。这是你得到的：

👉 查看完整定价 | 获取API密钥

年度计划节省25% --黄金年价格为18.74美元/月。

发展

# Clone the repository
git clone https://github.com/converteverything/converteverything-mcp.git
cd converteverything-mcp

# Install dependencies
npm install

# Build
npm run build

# Run in development mode
CONVERTEVERYTHING_API_KEY=ce_your_key npm run dev

许可证

MIT许可证-请参阅 许可证 了解详情。

链接

• 🏠 转换Everything.io --主网站
• 📖 API 文档 -API完整文档
• 🔑 获取API密钥 --管理您的密钥
• 💰 定价 --计划和功能
• 🐛 --报告错误
• 📧 联系 --联系我们

______________________________________________________________________

Built with 🔧 by the ConvertEverything.io team

Because life's too short for format incompatibility.