MCP 服务器
通过 Model Context Protocol,在 Claude Code、Cursor、VS Code 等 AI 助手与编程代理中使用 MLMux:获取模型列表、预估成本、生成图片以及创建视频。
端点与身份验证
MLMux MCP 服务器是一个支持 Streamable HTTP 传输协议的远程服务器。使用此 URL 将其添加到您的客户端:
https://www.mlmux.com/api/mcp在 Authorization: Bearer 请求头中使用您的 MLMux API 密钥进行身份验证;可在API 密钥中创建。服务器会在每次调用时将密钥传递给 MLMux API,且不会存储该密钥。若未提供密钥,则仅 list_models 和 estimate_cost 可用。
连接客户端
选择您的客户端并添加服务器。每个示例均从环境变量中读取密钥或提示输入密钥,因此密钥绝不会留在您可能共享的配置文件中。
claude mcp add --transport http mlmux https://www.mlmux.com/api/mcp \
--header "Authorization: Bearer $MLMUX_API_KEY"先在终端中设置 MLMUX_API_KEY,然后运行一次该命令。
任何支持通过带有自定义请求头的 Streamable HTTP 连接远程 MCP 服务器的客户端均以相同方式工作。
工具
服务器提供 7 个工具。客户端会将它们展示给助手,助手会根据您的需求选择相应的工具。
| 工具 | API 密钥 | 描述 |
|---|---|---|
list_models | 无需 | 列出图片和视频模型及其模型 ID、任务类型、尺寸规格以及各路由上的预估价格。 |
estimate_cost | 无需 | 预估在两种路由下生成一定数量图片或视频片段的成本,价格与价格计算器一致。 |
generate_image | 必需 | 根据提示词生成图片并返回其 URL。将扣除您的账户余额。 |
edit_image | 必需 | 根据提示词编辑或融合参考图片(公开 URL)并返回新图片 URL。将扣除您的账户余额。 |
create_video | 必需 | 启动 Seedance 视频任务(文生视频、图生视频或首尾帧生视频)并返回其任务 ID。视频生成成功时将扣除您的账户余额。 |
get_task | 必需 | 返回任务的状态;一旦成功,返回输出 URL 及扣费金额。 |
get_balance | 必需 | 返回您的积分余额。 |
计费
generate_image、edit_image 和 create_video 的计费方式与对应的 API 请求完全一致,遵循价格页面的费率:1 积分 = 1 美元,失败请求不扣费。大多数客户端会在运行工具调用前请求您的批准;若关注成本,可让助手先运行 estimate_cost。
限制
- 图片工具最长等待约 4 分钟获取结果。耗时较长的图片生成会返回任务 ID;可随后调用
get_task获取结果。 create_video会立即返回任务 ID。随后助手会调用get_task,直至视频准备就绪。- 通过 MCP 发起的请求计入您账户同时运行 60 个任务的上限。
- 目前暂不支持 OAuth 登录,因此 claude.ai 和 ChatGPT Web 应用等需要该功能的连接器目前无法连接。支持自定义请求头的客户端现已可正常使用。