面向 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,与网站相同。

  1. create_conversion_job - 返回 jobId 和 uploadUrl
  2. PUT 文件到 uploadUrl(Content-Type: application/octet-stream)
  3. confirm_upload
  4. start_conversion(可选先 update_conversion_job)
  5. get_conversion_status 直到 status 为 ready
  6. 从状态响应中的 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 提供商的完整智能体参考。

常见问题

不需要。MCP 服务器为公开,有公平使用限制,与网站相同。无需 OAuth 或账户。

不可以。create_conversion_job 返回签名 uploadUrl。直接 PUT 文件到该 URL(最大 500 MB),然后调用 confirm_upload。与浏览器上传器相同。

不收费。转换和下载免费,与 muxara.com 相同。

可以。在端口 3001 运行 Muxara worker,通过 MCP Inspector 或客户端连接 http://localhost:3001/mcp。