MCPMidjourney

关键词

图像生成MidjourneyAceDataCloudAI 工具集MCP 服务器

使用说明内容（Markdown格式）

MCPMidjourney 使用说明

  1. 项目简介
  • 这是一个基于 MCP（Model Context Protocol）的后端服务器，连接 AceDataCloud Midjourney API，提供一组图片、视频生成与处理工具，以及描述、提示模板等能力，供 MCP 客户端（如 Claude Desktop、VS Code 等）调用。
  1. 主要功能点
  • 资源与工具管理：注册并暴露多种 Midjourney 相关工具，如 midjourney_imagine、midjourney_transform、midjourney_blend、midjourney_describe、midjourney_edit、midjourney_generate_video、midjourney_translate、midjourney_get_task、midjourney_list_actions 等，以及相应的提示模板。
  • Prompts 支持：提供用于引导 LLM 的提示模板，帮助决定调用哪一工具及其参数。
  • MCP 传输模式：支持 stdio 与 HTTP（通过 FastMCP 框架实现），并提供健康端点与认证流程。
  • 安全与认证：HTTP 模式通过 Bearer Token 做请求级鉴权；本地模式使用环境变量 TOKEN 配置。
  • API 封装层：通过核心客户端封装 AceDataCloud 的 Midjourney API，处理 imagine/describe/edit/video/translate 等接口调用，并对结果进行统一格式化输出。
  • 配置与开发友好：提供详细的环境变量、默认模式、超时设置、日志等级等配置信息，便于本地开发与自部署。
  1. 安装步骤
  • 克隆并进入仓库：
    • 从 GitHub 克隆仓库并进入目录
  • 安装以及开发依赖：
    • 使用命令：pip install -e .
    • 或安装开发依赖：pip install -e ".[dev,test]"
  • 环境准备：
    • 复制并配置环境文件 .env（包括 ACEDATACLOUD_API_TOKEN、其他可选配置如 API 基地址、默认模式、超时等）
  • 启动服务器：
    • 使用 stdio 模式（默认）：
      • 直接运行 mcp-midjourney
    • 使用 HTTP 传输模式（需要额外依赖）：
      • 运行 mcp-midjourney --transport http --port 8000
  • 测试与健康检查：
    • 本地健康检查端点通常为 /health，HTTP 模式下需要携带 Bearer Token。
  1. 服务器配置（MCP 客户端连接信息示例） 说明：MCP 客户端需要提供服务器启动命令、参数等信息，用于连接并交互该 MCP 服务器。以下为准确的配置示例（JSON 格式，避免代码块）。

{ "server_name": "midjourney", "command": "mcp-midjourney", "args": [], "env": { "ACEDATACLOUD_API_TOKEN": "your_api_token_here" } // 说明：该配置用于 Claude Desktop/其它 MCP 客户端，表示使用本地命令启动 MCP 服务器，并通过环境变量提供 AceDataCloud API token。 // 如果你希望通过 HTTP 传输连接，请参考 README 的 Remote HTTP Mode 配置示例。 }

  1. 基本使用方法

  • 启动后：服务器将注册一系列 Midjourney 相关工具与提示模板，LLM 客户端可按需要调用。

  • 常用操作（示例性工作流程）：

    • 生成图片：midjourney_imagine(prompt="描述性文本")
    • 转换/变体：midjourney_transform(image_id, action="upscale2")
    • 使用参考图像生成：midjourney_with_reference(reference_image_url, prompt="风格描述")
    • 描述图像：midjourney_describe(image_url)
    • 生成视频：midjourney_generate_video(image_url, prompt="描述性文本")
    • 翻译中文提示：midjourney_translate(content="中文提示")
    • 查询任务状态：midjourney_get_task(task_id)

  • 注意事项：

    • 在本地模式下，ACEDATACLOUD_API_TOKEN 必须通过环境变量提供；在 HTTP 模式下，请求头部需要携带 Bearer Token。
    • 服务默认端口为 8000（HTTP 模式），可通过 --port 指定。

关键词 图像生成, Midjourney, AceDataCloud, AI 工具集, MCP 服务器

分类ID 6

服务器信息

访问项目