关于 Modelrunner
ModelRunner 是托管式 MCP 服务,可调用多个提供商的模型生成媒体。MCP 客户端可通过单一端点查找模型、查看输入要求、运行推理并获取结果。
主要功能
- 01生成图像、视频、音频和 3D 内容
- 02搜索目录并查看模型信息
- 03运行推理并返回托管 URL
- 04创建可复用的模型封装
- 05通过浏览器进行 OAuth 2.1 授权
适用场景
- 01从 MCP 客户端生成图像或视频
- 02生成音乐或转录语音
- 03运行推理前查看模型输入要求
MCP 相关
通过远程 Streamable HTTP 端点向 MCP 客户端提供 ModelRunner 的多提供商模型目录和推理工具。使用 OAuth 2.1 进行身份验证。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://mcp.modelrunner.run/mcpclaude mcp add --transport http modelrunner https://mcp.modelrunner.run/mcp{"mcpServers":{"modelrunner":{"type":"http","url":"https://mcp.modelrunner.run/mcp"}}}在 Cursor 中打开{"servers":{"modelrunner":{"type":"http","url":"https://mcp.modelrunner.run/mcp"}}}在 VS Code 中打开{"mcpServers":{"modelrunner":{"type":"http","url":"https://mcp.modelrunner.run/mcp"}}}{"mcpServers":{"modelrunner":{"serverUrl":"https://mcp.modelrunner.run/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
ModelRunner MCP 服务
面向 ModelRunner 的官方 Model Context Protocol(MCP)服务——可通过 Claude、Cursor 和任何 MCP 客户端运行 100 多种 AI 模型,支持图像、视频、音频和 3D 生成。
- 端点:
https://mcp.modelrunner.run/mcp(远程服务,Streamable HTTP) - 身份验证: OAuth 2.1——只需在浏览器中授权一次;无需在配置中粘贴 API 密钥
- 注册表名称:
ai.modelrunner/mcp - 设置指南和完整工具参考: modelrunner.ai/mcp
与单一供应商的 MCP 服务不同,只需建立一个连接,即可使用 ModelRunner 的完整目录——通过一个端点和一个按使用量付费的账户,访问多个 AI 提供商的模型。你的助手可以搜索目录、查看模型的输入架构、运行推理,并直接在对话中获取托管 URL 形式的结果。
正在维护开源项目? ModelRunner 为活跃的开源 项目提供每月免费 API 额度——请通过 modelrunner.ai/oss-program 申请。
快速开始
Claude Code
claude mcp add --transport http modelrunner https://mcp.modelrunner.run/mcp
Cursor / VS Code(原生远程 URL)
{
"mcpServers": {
"modelrunner": { "url": "https://mcp.modelrunner.run/mcp" }
}
}
Claude Desktop 或任何仅支持 stdio 的客户端(通过 mcp-remote)
{
"mcpServers": {
"modelrunner": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.modelrunner.run/mcp"]
}
}
}
首次使用时,AI 助手会打开浏览器窗口,让你登录 ModelRunner——设置就此完成。
工具
| 分组 | 工具 |
|---|---|
| 发现和查看 | search、list_models、list_wrappers、recommended_models、recommended_wrappers、get_model、get_wrapper、get_model_raw_schema、get_wrapper_raw_schema、get_wrapper_prompt_template、get_wrapper_field_mappings |
| 运行和获取 | run_model、wait_for_request、get_request、list_my_requests |
| 上传文件 | create_upload_url、upload_file |
| 编写封装器 | wrapper_authoring_guide、create_wrapper、patch_wrapper、preview_wrapper、list_my_wrappers、delete_wrapper |
“封装器”是可在基础模型之上构建的可复用简化接口——包含几个易用的输入项、提示词模板和预置设置,并通过与 run_model 类似的工具运行。
模型和功能
目录涵盖文本生成图像、图像生成图像、文本生成视频、图像生成视频、视频生成视频、音乐生成、语音转文本和图像转 3D,包括 Kling、HiDream、Hunyuan Image、Stable Audio 和 Rodin 等模型。按功能浏览:
定价
连接免费。模型运行按次计费,使用预付额度——无需订阅。每个模型的确切价格(按图像、视频秒数、百万像素等计费)均显示在其模型页面和定价页面上。
关于此代码仓库
此代码仓库介绍托管的 ModelRunner MCP 服务。服务本身由 ModelRunner 官方运营,是一个远程 MCP 端点——无需安装或自托管;以上配置就是完整的集成内容。
许可证
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。