图像生成服务器

项目简介

Image-Gen-Server 是一个基于即梦 AI 的图像生成服务，旨在与 Cursor IDE 集成。该服务能够根据文本描述生成图片，并提供下载和保存功能。

功能特性

1. 完美集成：支持与 Cursor 和 Claude 等工具无缝集成。
2. 文本到图像生成：通过输入文本描述生成高质量的图像。
3. 自动保存：自动生成并保存图片文件。
4. 自定义路径：允许设置图片保存的目录。
5. 批量生成：一次生成四张不同风格的图片。

安装指南

1. 使用 Smithery CLI 安装

smith install image-gen-server

2. 手动安装

1. 克隆项目仓库：

   git clone https://github.com/your-username/image-gen-server.git
   cd image-gen-server
   

2. 安装依赖项：
   • Python 环境要求：使用 Python 3.8 或更高版本。
   • 安装依赖：

     pip install fastmcp proxy[jimeng]
     

3. 配置项目：
   • 修改 server.py 文件中的 IMG_SAVA_FOLDER 变量以设置默认保存路径。
   • 配置 config.json 文件，添加即梦 AI 的 API 密钥。

在 Cursor 中集成

1. 打开 Cursor 设置

• 点击菜单栏的 Cursor > Settings

2. 添加 MCP 服务器

• 进入 Tools 部分，选择 MCP Servers
• 点击 Add Server 按钮
• 填写以下信息：
  • Name: Image-Gen-Server
  • Command:

    uv run --with fastmcp fastmcp run D:/path/to/server.py
    

  • Working Directory: 设置为服务器脚本所在的目录

3. 完成配置

• 点击 Add，完成服务器的添加。

使用说明

1. 在 Cursor 的 Agent 模式下：

   • 示例 1：根据项目需求生成产品 logo 并保存到项目目录下的 images 文件夹。
   • 示例 2：为网站首页制作 banner 图片。

2. 调用接口：

   from image_gen_server import generate_image
   
   images = generate_image(
       prompt="设计一个现代简约风格的logo",
       save_path="path/to/images/logo.jpg",
       width=1024,
       height=1024
   )
   

技术实现

• server.py 使用了 fastmcp 库实现了 MCP 服务器功能，为 Cursor 和 Claude 提供服务。
• 调用了 proxy.jimeng 模块与即梦 AI 进行交互，支持以下功能：
  • 图像生成 (generate_images)
  • 同步对话补全 (create_completion)
  • 流式对话补全 (create_completion_stream)
  • 支持多账号 token
  • 完整的错误处理机制

示例代码

# 在 Cursor 的 Agent 模式下：
# 示例一：生成产品 logo
根据提供过你的项目需求，帮我生成一张产品logo，放在项目目录images下面

# 示例二：设计网站首页 banner
根据项目需求，帮我制作网站的首页，头部需要有banner图片。

许可证

本项目采用 MIT License，作者为凌封。

常见问题解决

1. 配置完成后跳出黑窗口且很快消失

   • 可能原因：
     • 服务器命令填写错误，检查路径是否正确，确保不包含中文字符，并使用一致的路径分隔符。
     • 环境未正确安装，确认已安装所有依赖项。
     • 使用的终端与配置不符，尝试在不同的终端运行（如 Git Bash、Cmd、PowerShell 或 WSL）。

2. 调试服务器

   uv run --with fastmcp fastmcp dev D:/path/to/server.py
   

   这会打开一个调试界面：http://localhost:5173/，可通过浏览器访问 MCP Inspector 进行调试。

更多详细信息请参考项目文档和相关技术资料。