ModelRunner MCP server
2026년 9월 7일 커밋단일 API 연결을 통해 이미지, 비디오, 오디오 및 3D 생성을 위한 100개 이상의 AI 모델을 실행합니다.
다른 이름 modelrunner/modelrunner-mcp, modelrunner-mcp
- 스타
- 0
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- 1.5.0
- 마지막 커밋
- 2026년 9월 7일
- 라이선스
- MIT
ModelRunner MCP란?
ModelRunner은(는) MCP server입니다. 단일 API 연결을 통해 이미지, 비디오, 오디오 및 3D 생성을 위한 100개 이상의 AI 모델을 실행합니다.
프로젝트 README에서 생성된 요약
ModelRunner MCP server 정보
ModelRunner를 사용하면 AI 어시스턴트 내부에서 이미지, 비디오, 오디오 및 3D 에셋을 생성할 수 있습니다. 이 원격 MCP server는 Claude, Cursor 및 기타 클라이언트를 다양한 제공업체의 100개 이상의 모델 카탈로그와 연결합니다. 여러 개의 개별 구독을 관리하는 대신, 단일 종량제 계정을 사용하여 text-to-video, 음악 생성, speech-to-text와 같은 다양한 기능을 활용할 수 있습니다.
설정은 OAuth 2.1을 통해 이루어지므로, 설정 파일에 API key를 붙여넣는 대신 브라우저 창에서 인증을 진행합니다. 서버는 특정 엔드포인트에 원격으로 호스팅되므로 로컬에 설치하거나 직접 호스팅할 필요가 없습니다. Claude Code, Cursor 또는 데스크톱 클라이언트를 위한 mcp-remote를 통해 직접 사용할 수 있습니다.
개발자는 search, list_models, run_model과 같은 도구를 사용하여 카탈로그와 상호작용할 수 있습니다. 또한 프롬프트 템플릿과 특정 설정을 사용하여 기본 모델 위에 구축된 단순화된 인터페이스인 wrapper를 생성하는 기능도 지원합니다. 결과는 호스팅된 URL 형태로 대화창에 직접 반환됩니다.
활용 사례
- 1사용 가능한 생성 모델 탐색카탈로그 검색을 통해 창의적인 작업을 수행할 특정 AI 모델을 어시스턴트에게 찾아달라고 요청합니다.
- 2멀티미디어 에셋 생성AI 클라이언트에 Kling 또는 Stable Audio와 같은 특정 모델을 사용하여 비디오나 이미지를 생성하도록 지시합니다.
- 3커스텀 모델 인터페이스 구축복잡한 기본 모델과의 상호작용 방식을 표준화하기 위해 wrapper라고 불리는 단순화된 재사용 가능 인터페이스를 생성합니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
ModelRunner MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 ModelRunner MCP 설치
$ claude mcp add --transport http modelrunner-mcp https://mcp.modelrunner.run/mcpCursor에 ModelRunner MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"modelrunner-mcp": {
"url": "https://mcp.modelrunner.run/mcp"
}
}
}VS Code에 ModelRunner MCP 설치
.vscode/mcp.json
{
"servers": {
"modelrunner-mcp": {
"type": "http",
"url": "https://mcp.modelrunner.run/mcp"
}
}
}VS Code CLI에 ModelRunner MCP 설치
$ code --add-mcp '{"name":"modelrunner-mcp","type":"http","url":"https://mcp.modelrunner.run/mcp"}'Codex에 ModelRunner MCP 설치
$ codex mcp add modelrunner-mcp --url https://mcp.modelrunner.run/mcpCodex config.toml에 ModelRunner MCP 설치
~/.codex/config.toml
[mcp_servers.modelrunner-mcp] url = "https://mcp.modelrunner.run/mcp"
Gemini CLI에 ModelRunner MCP 설치
$ gemini mcp add -s user --transport http modelrunner-mcp https://mcp.modelrunner.run/mcpGemini settings.json에 ModelRunner MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"modelrunner-mcp": {
"url": "https://mcp.modelrunner.run/mcp",
"type": "http"
}
}
}자동 검사
2026년 11월 15일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능modelrunner/modelrunner-mcp is public and reachablegithub.com/modelrunner/modelrunner-mcp ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-11-06github.com/modelrunner/modelrunner-mcp ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답HTTPS endpoint answered 401 (sign-in required)통과
README
GitHub에서 보기ModelRunner MCP Server
Official Model Context Protocol (MCP) server for ModelRunner — run 100+ AI models across image, video, audio, and 3D generation from Claude, Cursor, and any MCP client.
- Endpoint:
https://mcp.modelrunner.run/mcp(remote server, Streamable HTTP) - Auth: OAuth 2.1 — your browser authorizes once; no API key is pasted into config
- Registry name:
ai.modelrunner/mcp - Setup guide & full tool reference: modelrunner.ai/mcp
Unlike single-vendor MCP servers, one connection exposes the entire ModelRunner catalog — models from multiple AI providers behind one endpoint and one pay-per-use billing account. Your assistant can search the catalog, inspect a model's input schema, run inference, and get results back as hosted URLs directly in the conversation.
Maintaining an open-source project? ModelRunner gives active open-source projects free monthly API credits — apply at modelrunner.ai/oss-program.
Quick start
Claude Code
claude mcp add --transport http modelrunner https://mcp.modelrunner.run/mcp
Cursor / VS Code (native remote URL)
{
"mcpServers": {
"modelrunner": { "url": "https://mcp.modelrunner.run/mcp" }
}
}
Claude Desktop or any stdio-only client (via mcp-remote)
{
"mcpServers": {
"modelrunner": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.modelrunner.run/mcp"]
}
}
}
On first use your AI assistant opens a browser window to sign in to ModelRunner — that's the whole setup.
Tools
| Group | Tools |
|---|---|
| Discover & inspect | 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 & fetch | run_model, wait_for_request, get_request, list_my_requests |
| Upload files | create_upload_url, upload_file |
| Author wrappers | wrapper_authoring_guide, create_wrapper, patch_wrapper, preview_wrapper, list_my_wrappers, delete_wrapper |
"Wrappers" are reusable, simplified interfaces you can build over base models — a few friendly inputs, a prompt template, and baked-in settings — and they run through the same run_model-style tools.
Models & capabilities
The catalog covers text-to-image, image-to-image, text-to-video, image-to-video, video-to-video, music generation, speech-to-text, and image-to-3D, including models like Kling, HiDream, Hunyuan Image, Stable Audio, and Rodin. Browse by capability:
- Text-to-Image API · Image-to-Image API
- Text-to-Video API · Image-to-Video API · Video-to-Video API
- Music Generation API · Speech-to-Text API
- Image-to-3D API
Full catalog: modelrunner.ai/models
Pricing
Free to connect. Model runs are pay-per-use from prepaid credits — no subscription. Every model's exact price (per image, per second of video, per megapixel, …) is shown on its model page and on the pricing page.
About this repository
This repository documents the hosted ModelRunner MCP server. The server itself is first-party, run by ModelRunner as a remote MCP endpoint — there is nothing to install or self-host; the configs above are the entire integration.
- Landing page: modelrunner.ai/mcp
- Docs: modelrunner.ai/docs
- Model catalog: modelrunner.ai/models
License
ModelRunner MCP 질문
ModelRunner MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add --transport http modelrunner-mcp https://mcp.modelrunner.run/mcp를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
ModelRunner MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
ModelRunner 인증은 어떻게 하나요?
이 서버는 OAuth 2.1을 사용합니다. 브라우저를 통해 한 번만 인증하면 설정 파일에 API key를 직접 붙여넣을 필요가 없습니다.
어떤 종류의 AI 모델을 사용할 수 있나요?
text-to-image, image-to-image, text-to-video, image-to-video, video-to-video, 음악 생성, speech-to-text, image-to-3D 모델을 포함합니다.
모델 사용을 위한 구독료가 있나요?
아니요, 구독료는 없습니다. 선불 크레딧을 기반으로 사용한 만큼 비용을 지불하는 종량제 방식입니다.
서버를 직접 호스팅해야 하나요?
아니요, 서버는 ModelRunner에서 제공하는 원격 엔드포인트이므로 별도로 설치하거나 직접 호스팅할 필요가 없습니다.