Image-Gen-Server
local-only server
The server can only run on the client’s local machine because it depends on local resources.
Image-Gen-Server
基于即梦AI的图像生成服务,专门设计用于与Cursor IDE集成。它接收来自Cursor的文本描述,生成相应的图像,并提供图片下载和保存功能。
此插件的开发过程可以看我的网站:开发一个MCP Server与Cursor集成,给Cursor插上翅膀!
更多AI知识,见AI全书(https://aibook.ren)
特性
- 与Cursor IDE完美集成
- 支持文本到图像的生成
- 自动保存生成的图像
- 支持自定义保存路径
- 一次生成四张图,供更多选择
安装
- 环境准备,MCP比较新的东西,依赖环境版本都比较新
- python 3.10+
- 安装npm
- 安装nodejs(实测v15 v16都不行,开发环境验证v20可以,其他未验证)
- 安装 pip install uv
- 如果要调试,还需要安装这个:npm install -g @modelcontextprotocol/inspector@0.4.0
- 克隆项目Copy
- 安装依赖Copy
- 设置即梦Token和图片默认保存地址
修改server.py文件里面这两个配置Copy
Cursor集成
- 打开Cursor设置
- 点击左下角的设置图标
- 选择 Features > MCP Servers
- 点击 "Add new MCP server"
- 填写服务器配置
- Name:
image-gen-server
(或其他你喜欢的名称) - Type:
command
- Command: 注意:将路径替换为你的实际项目路径Copy
- Windows示例:
uv run --with fastmcp fastmcp run D:/code/image-gen-service/server.py
- macOS/Linux示例:
uv run --with fastmcp fastmcp run /Users/username/code/image-gen-server/server.py
windows路径问题比较多,D:/code/image-gen-server/server.py 各种斜杠都试下
填写完后,会弹出一个黑窗口,然后你就可以叫Cursor给你生成需要的图片了,目前黑窗口会一直运行,目前还没办法解决弹出这个的问题
- Windows示例:
- Name:
使用方法
在Cursor中,你要让cursor生成图片,在agent模式下,你提示它了解下图片工具使用方法,然后直接提你要生成的图片要求,保存位置就行了
获取即梦Token
- 访问 即梦
- 登录账号
- 按F12打开开发者工具
- 在Application > Cookies中找到
sessionid
- 将找到的sessionid设置到server.py的JIMENG_API_TOKEN中
工具函数说明
generate_image
技术实现
- server.py采用了fastmcp实现了mcp sever的能力,提供给cursor/claude使用2.sever.py调用了proxy.jimeng模块逆向与即梦AI进行交互。
proxy.jimeng逆向模块也可以单独install使用,主要提供了以下主要功能:
- 图像生成(generate_images)
- 同步对话补全(create_completion)
- 流式对话补全(create_completion_stream)
- 多账号token支持
- 完整的错误处理
更多详细信息请参考proxy/jimeng/README.md
。
使用示例
许可证
MIT License 作者:凌封
故障排除
1.配置完后跳出黑窗口,很快消失,工具状态变成No tools found
原因:没有正常启动,一般有以下原因
- 配置命令不对,检查命令是否正确,一般是server.py路径不对,或者路径中包含中文,或者正反斜杠不对
- 依赖的环境没准备好
- 依赖运行的终端不对,像我windows的,终端有git bash,cmd,powershell,wsl等,这些终端都试下,cursor配置我这默认终端是cmd,如果你在这对应终端运行报错,一般是环境没装好,安装环境就可以
2.正常运行后,想看调用日志,或者调试怎么弄
命令改成以下:
即把最后一个run 改成 dev。
或者找个终端运行以下命令进入调试模式:
会有一个调试地址输出:http://localhost:5173/,你可以浏览器打开这地址MCP Inspector进行调试,具体MCP Inspector怎么使用,可以看官方文档
This server cannot be installed
A MCP server that integrates with Cursor IDE to generate images based on text descriptions using JiMeng AI, allowing users to create and save custom images directly within their development environment.