跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt

Use this file to discover all available pages before exploring further.

MCP(Model Context Protocol) 是由 Anthropic 推出的模型上下文协议,允许 AI 模型(如 Claude、GPT 等)通过标准化接口调用外部工具。通过 AceData Cloud 提供的 Midjourney MCP Server,你可以在 Claude Desktop、VS Code、Cursor 等 AI 客户端中直接生成和编辑 AI 图像。

功能概览

Midjourney MCP Server 提供以下核心功能:
  • 图像生成(Imagine) — 通过文本提示词生成高质量图像
  • 图像编辑 — 对已生成的图像进行局部修改
  • 图像变换 — 放大、缩放、平移已有图像
  • 图像混合(Blend) — 将多张图像融合为新图像
  • 参考图生成 — 使用参考图片引导生成
  • 图像描述(Describe) — 根据图片生成文本描述
  • 提示词翻译 — 将中文提示词翻译为英文
  • 种子获取 — 获取图像的 seed 值用于复现
  • 视频生成 — 基于图像生成动态视频
  • 任务查询 — 监控生成进度并获取结果

前置准备

使用前,你需要获取 AceData Cloud API Token:
  1. 注册或登录 AceData Cloud 平台
  2. 前往 Midjourney Imagine API 页面
  3. 点击「Acquire」获取 API Token(首次申请赠送免费额度)

安装配置

方式一:pip 安装(推荐)

pip install mcp-midjourney

方式二:源码安装

git clone https://github.com/AceDataCloud/MCPMidjourney.git
cd MCPMidjourney
pip install -e .
安装完成后,即可使用 mcp-midjourney 命令启动服务。

在 Claude Desktop 中使用

编辑 Claude Desktop 配置文件:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
添加以下配置:
{
  "mcpServers": {
    "midjourney": {
      "command": "mcp-midjourney",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "你的API Token"
      }
    }
  }
}
如果使用 uvx(无需提前安装包):
{
  "mcpServers": {
    "midjourney": {
      "command": "uvx",
      "args": ["mcp-midjourney"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "你的API Token"
      }
    }
  }
}
保存配置后重启 Claude Desktop,即可在对话中使用 Midjourney 相关工具。

在 VS Code / Cursor 中使用

在项目根目录创建 .vscode/mcp.json
{
  "servers": {
    "midjourney": {
      "command": "mcp-midjourney",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "你的API Token"
      }
    }
  }
}
或者使用 uvx
{
  "servers": {
    "midjourney": {
      "command": "uvx",
      "args": ["mcp-midjourney"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "你的API Token"
      }
    }
  }
}

可用工具列表

工具名说明
midjourney_imagine通过文本提示词生成图像
midjourney_edit编辑已有图像的局部区域
midjourney_transform放大、缩放、平移已有图像
midjourney_blend将多张图像混合为一张
midjourney_with_reference使用参考图生成图像
midjourney_describe根据图片生成文本描述
midjourney_translate翻译提示词为英文
midjourney_get_seed获取图像的 seed 值
midjourney_generate_video基于图像生成视频
midjourney_extend_video延长已有视频
midjourney_get_task查询单个任务状态
midjourney_get_tasks_batch批量查询任务状态

使用示例

配置完成后,你可以在 AI 客户端中直接用自然语言调用这些功能,例如:
  • 「帮我生成一张赛博朋克风格的城市夜景」
  • 「把这张图片的背景改成海边」
  • 「将这四张图片混合成一张」
  • 「描述一下这张图片里的内容」
  • 「把这张图片做成视频」
  • 「放大这张图片的第二个变体」

更多信息