midjourney-mcp

RunAPI Midjourney MCP 服务

为 AI Agent 提供 Midjourney API 访问：通过一个专用 MCP 服务运行图像和视频生成操作、轮询异步结果并查询价格。

_{适用于 Claude Code、Codex、Cursor、Windsurf、VS Code、Roo Code 及任何兼容 MCP 的宿主。}

安装 | 工具 | 模型 | Agent 提示词 | 配置 | 链接

---

为什么选择这个包？

@runapi.ai/midjourney-mcp 是一个专为 RunAPI 上的 Midjourney 模型系列打造的 Model Context Protocol 服务。 它让兼容 MCP 的助手可直接访问 7 个端点和 3 种模型变体，无需加载完整的 RunAPI 模型目录。

如果希望 Agent 专注于 Midjourney，请使用这个按模型划分的服务。如果希望一个助手能够发现 RunAPI 的所有模型系列，请使用 @runapi.ai/mcp。

---

安装

将其添加到 Claude Code：

claude mcp add midjourney -s user -- npx -y @runapi.ai/midjourney-mcp

如果要让仓库共享此服务，请使用项目范围：

claude mcp add midjourney -s project -- npx -y @runapi.ai/midjourney-mcp

Codex、Cursor、Windsurf、VS Code、Roo Code 和其他 MCP 宿主可以使用相同的 stdio 命令：

{
  "mcpServers": {
    "midjourney": {
      "command": "npx",
      "args": ["-y", "@runapi.ai/midjourney-mcp"]
    }
  }
}

登录前即可使用 check_pricing。要创建任务和轮询状态，请让助手调用 login 工具。该工具会打开浏览器登录，并将凭据保存到 ~/.config/runapi/config.json，此文件也由 runapi login 使用。 无头环境和 CI 宿主也可以在启动 MCP 宿主前设置 RUNAPI_API_KEY。

examples/ 中提供了适用于 Claude、Cursor、Windsurf、VS Code 和 Roo Code 的现成示例。

---

工具

工具	需要身份验证	用途
edit_image	是	创建 Midjourney 图像编辑任务，并可选择等待任务达到终止状态。返回任务 ID、状态和输出 URL。
extend_video	是	创建 Midjourney 视频延长任务，并可选择等待任务达到终止状态。返回任务 ID、状态和输出 URL。
get_seed	是	同步运行 Midjourney 获取种子操作。返回操作结果。
image_to_prompt	是	同步运行 Midjourney 图像转提示词操作。返回操作结果。
image_to_video	是	创建 Midjourney 图像转视频任务，并可选择等待任务达到终止状态。返回任务 ID、状态和输出 URL。
shorten_prompt	是	同步运行 Midjourney 提示词缩短操作。返回操作结果。
text_to_image	是	创建 Midjourney 文本转图像任务，并可选择等待任务达到终止状态。返回任务 ID、状态和输出 URL。
get_task	是	获取现有任务的当前状态和最新负载。
check_pricing	否	查询 Midjourney 模型和端点的当前价格。

---

模型

Midjourney 涵盖 3 种模型变体，分布在 7 个端点上。每个工具接受其对应列出的模型：

工具	模型
edit_image	midjourney-edit-image
extend_video	midjourney-image-to-video
get_seed	无模型参数
image_to_prompt	无模型参数
image_to_video	midjourney-image-to-video
shorten_prompt	无模型参数
text_to_image	midjourney-v8.1

模型可用性可能会随着版本发布而变化。请使用 check_pricing 或 Midjourney 模型页面查看当前目录。

---

Agent 提示词

用自然语言向助手提问；它可以查看价格、创建任务，并返回任务 ID 和输出 URL。

创建任务

Run a Midjourney edit image task with RunAPI.

助手可以调用 check_pricing，然后调用 edit_image，并返回任务 ID、状态和输出 URL。

提交但不等待

Create the task but don't wait for it to finish.

助手调用创建工具时设置 wait: false，并返回任务 ID。之后可使用 get_task 查看任务状态。

创建前查看价格

Check current Midjourney pricing, then create the task if it matches my request.

助手调用 check_pricing，并可链接到 Midjourney 模型页面，以查看权威目录条目。

---

配置

服务按以下顺序解析身份验证信息：

1. RUNAPI_API_KEY 环境变量，适用于无头主机和 CI 主机
2. ~/.config/runapi/config.json，由 MCP login 工具或 runapi login 创建
3. 未设置密钥，此时仍可使用 check_pricing

配置文件通常由登录流程管理。预先配置的无头环境配置可使用：

{
  "apiKey": "your_runapi_key"
}

请勿提交真实 API 密钥。

---

链接

资源	URL
Midjourney 模型页面	https://runapi.ai/models/midjourney
npm 包	@runapi.ai/midjourney-mcp
GitHub 仓库	runapi-ai/midjourney-mcp
RunAPI MCP 概览	runapi.ai/mcp
RunAPI 文档	runapi.ai/docs

---

许可证

根据 Apache License, Version 2.0 授权。