JinDaGe - image-gen-server MCP Details

article

README

🚀 图像生成服务器

本项目 Image-Gen-Server 是基于即梦 AI 的图像生成服务，致力于与 Cursor IDE 集成。它能依据文本描述生成图片，还具备下载和保存功能，为图像生成需求提供了便捷的解决方案。

🚀 快速开始

Image-Gen-Server 是专为与 Cursor IDE 集成而打造的图像生成服务。借助该服务，你可以通过文本描述轻松生成图片，并进行下载和保存操作。

✨ 主要特性

💯 完美集成：支持与 Cursor 和 Claude 等工具无缝集成，为用户提供统一的操作体验。
📝 文本到图像生成：只需输入文本描述，即可生成高质量的图像，满足多样化的创作需求。
💾 自动保存：自动生成并保存图片文件，节省用户手动操作的时间。
📂 自定义路径：允许用户设置图片保存的目录，方便管理生成的图片。
📦 批量生成：一次可生成四张不同风格的图片，提高创作效率。

📦 安装指南

1. 使用 Smithery CLI 安装

smith install image-gen-server

2. 手动安装

克隆项目仓库：

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

安装依赖项：
- Python 环境要求：使用 Python 3.8 或更高版本。
- 安装依赖：
```
pip install fastmcp proxy[jimeng]
```
配置项目：
- 修改 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
)

常见问题解决

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

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

2. 调试服务器

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

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

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

🔧 技术细节

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，作者为凌封。

image-gen-server