面向 AI 智能体
使用 MCP 转换视频
Muxara 提供远程 MCP 服务器,让 Claude、Cursor 等智能体创建转换任务、上传媒体并下载结果 - 与 muxara.com 相同的 500 MB 上限和公平使用限制。
工具
八个 MCP 工具镜像网站转换流程。智能体通过下方端点的 Streamable HTTP 调用它们。
list_conversions列出全部 82 个转换 slug,含接受的输入扩展名和输出格式。
get_conversion_defaults获取 slug 的默认及有效编解码器、质量和裁剪参数。
create_conversion_job创建任务并获取签名上传 URL(输入最大 500 MB)。
confirm_upload确认文件已上传到签名 URL。
update_conversion_job处理前更改输出格式或转换设置。
start_conversion在 worker 上排队 FFmpeg 转换。
get_conversion_status就绪后轮询任务状态和进度。
get_media_info探测已上传文件的时长、分辨率、编解码器和比特率。
使用场景
AI 聊天助手
用户请助手将 MKV 转为 MP4。智能体列出格式、创建任务、引导上传,完成后返回下载链接。
自动化流水线
脚本或 CI 任务创建转换、通过签名 URL 上传并无浏览器轮询状态 - 适用于媒体预处理工作流。
格式发现
智能体在根据文件扩展名和目标设备选择合适 slug 前,调用 list_conversions 和 get_conversion_defaults。
编辑器与 CMS 集成
构建自定义工具,将转码交给 Muxara,同时保持与公开网站相同的限制。
工作流
文件字节不通过 MCP 工具调用发送。上传使用签名 URL,与网站相同。
- create_conversion_job - 返回 jobId 和 uploadUrl
- PUT 文件到 uploadUrl(Content-Type: application/octet-stream)
- confirm_upload
- start_conversion(可选先 update_conversion_job)
- get_conversion_status 直到 status 为 ready
- 从状态响应中的 URL 下载
连接
使用 Streamable HTTP 传输。规范端点为 https://api.muxara.com/mcp(别名:/sse)。
Cursor
添加到 MCP 配置(.cursor/mcp.json 或 Cursor 设置):
{
"mcpServers": {
"muxara": {
"url": "https://api.muxara.com/mcp"
}
}
}MCP Inspector
运行 Inspector,选择 Streamable HTTP 并输入完整端点 URL:
npx @modelcontextprotocol/inspector
# Streamable HTTP → https://api.muxara.com/mcp身份验证
MCP 服务器为公开 - 无需 API 密钥、OAuth 或 Muxara 账户。
- 无需 API 密钥或注册
- api.muxara.com/mcp 上的 Streamable HTTP
- 适用公平使用速率限制
- 免费转换和下载
与网站相同的限制
MCP 工具委托给与 muxara.com 相同的任务 API。这些限制适用于每个客户端。
| 最大上传 | 每个文件 500 MB |
|---|---|
| 任务创建 | 每小时 20 个任务(公平使用限制) |
| API 请求 | 每分钟 120 次请求(公平使用限制) |
| 文件保留 | 24 小时 |
| 转换对 | 82 个 slug |
| 费用 | 免费 - 转换并下载无需付费(每文件最多 500 MB,适用公平使用限制)。 |
文档
机器可读的发现文件及面向 LLM 提供商的完整智能体参考。
- llms.txt
面向 LLM 智能体的精选站点索引
- llms-full.txt
含工具、API 和转换指南的完整参考
- .well-known/mcp.json
MCP 服务器发现元数据
- .well-known/mcp/server-card.json
工具列表、限制和端点详情