MeiGen MCP 服务器

关键词

本地生成图像AI工具集成工作流管理提示增强

使用说明

  • 项目简介 MeiGen MCP 服务器是一个基于 MCP 协议的本地后端，提供资源访问、工具调用、Prompt 渲染等功能，供 LLM 客户端通过 JSON-RPC 与其进行交互。当前实现通过 STDIO 传输，便于与 Claude 系统等本地工具集成，并支持 MeiGen、OpenAI 兼容模型以及本地 ComfyUI 工作流的图片生成能力。

  • 主要功能点

    1. 提供图片生成能力的多提供商接入：MeiGen 平台、OpenAI 兼容接口、ComfyUI 本地工作流。
    2. 登记并暴露多种 MCP Tools：enhance_prompt、search_gallery、list_models、get_inspiration、upload_reference_image、manage_preferences、comfyui_workflow、generate_image 等，覆盖从灵感获取、提示增强到实际生成的整条链路。
    3. Prompts 库与管理：本地提示库加载、关键词检索、随机浏览、收藏与最近生成记录。
    4. 桌面级图片上传与引用：支持将本地图片压缩并上传到对象存储，返回公开URL，供 generate_image 使用参考。
    5. ComfyUI 工作流管理：导入、查看、修改、删除、查看可编辑参数等，确保本地 GPU 加速生成的可控性。
    6. 持久化的用户偏好与设置：默认风格、宽高比、模型、风格笔记等，便于会话间保持一致性。
    7. 会话与错误处理：对常见问题提供清晰提示与自动化处理路径，包含异步进度通知、错误分类与重试逻辑。

  • 安装步骤

    1. 安装依赖：将仓库克隆到本地或下载源码后，在项目根目录执行安装（如 npm install）。
    2. 构建/编译：将 TypeScript 源代码编译到 dist 目录（通常执行构建脚本，如 npm run build，若无则使用 tsc）。
    3. 启动服务器：构建完成后，使用 Node 启动入口，服务会通过 STDIO 传输与客户端对接（通常在命令行或被 Claude Code 等工具以 STDIO 形式接入）。
    4. 配置依赖：根据需要设置 MeiGen API Token、MeiGen Base URL、OpenAI API Key、ComfyUI 地址等环境变量，便于不同提供商的工作流正常工作。

  • 服务器配置（MCP 客户端配置信息） 说明：MCP 客户端需要配置一个 MCP 服务器，包含服务器名称、启动命令及参数，以便建立 JSON-RPC 通道。本服务器的名称为 meigen（实现中明确作为服务器名称），启动入口为 dist/index.js，工作模式通过 STDIO 传输。以下为示例配置描述（JSON 格式，供参考，不作为代码块呈现）： { "server": { "name": "meiGen-mcp", "command": "node", "args": ["dist/index.js"], "transport": "stdio", "description": "MeiGen MCP 服务器，提供资源、工具、Prompts，并支持 MeiGen、OpenAI、ComfyUI 的图片生成能力（通过 STDIO 与客户端通信）" } } 使用要点：

    • server.name：为 MCP 客户端在会话中显示的服务器名称，应与实现中的名称保持一致，便于区分和管理。
    • server.command/server.args：实际启动服务器的命令和参数，需指向编译后的入口文件 dist/index.js。
    • transport：本实现使用 STDIO 作为传输通道，适合与 Claude Code、OpenClaw 等本地集成使用。
      注：MCP 客户端在建立连接前，并不需要额外的代码实现，只需提供上述连接信息即可启动与服务器的通信。

  • 基本使用方法

    • 启动后，MCP 客户端通过 STDIO 与服务器建立连接，Client 端可调用以下工具：enhance_prompt、search_gallery、get_inspiration、list_models、upload_reference_image、manage_preferences、comfyui_workflow、generate_image 等。
    • 通过 enhance_prompt，可以把用户的简单描述转化为高质量提示；通过 search_gallery 获取灵感并浏览 prompt；通过 get_inspiration 获取完整的提示及图片链接；通过 generate_image 选择不同提供商进行图片生成（MeiGen、OpenAI、ComfyUI），并可传入参考图片、目标模型、宽高比等参数进行定制。
    • 若需要本地图片支持，先用 upload_reference_image 将本地图片上传并获取公开 URL，再在生成时将其添加为 referenceImages。
    • 如遇错误，服务会返回清晰的错误信息，并尽量给出重试与替代方案。

  • 运行与维护要点

    • 本地环境需具备 Node.js、相关依赖库以及如 ComfyUI、MeiGen 等服务的可用性。
    • MeiGen 相关 Token/Key、ComfyUI 地址、OpenAI Key 等敏感信息建议通过环境变量进行管理。
    • 如需扩展功能，可在 src 目录下新增工具或提供商实现，并在 server.ts 统一注册。

  • 备注

    • 本实现具备完整的 MCP 服务器结构，包含服务器核心、工具注册、Prompts、资源上传、工作流管理、偏好设置等，且具备多提供商生成能力和本地工作流的支持，属于可运行且具备实际功能的 MCP 服务器实现。

服务器信息

访问项目