使用说明
ImageGen MCP服务器
使用OpenRouter和Google Gemini生成和编辑AI图像的MCP（模型上下文协议）服务器。
特性
- 生成图像 使用Gemini Flash图像预览从文本提示中
- 编辑现有图像 使用自然语言指令（例如，“使天空变成橙色”）
- 对话持久性 -使用保存的对话历史记录从您中断的地方继续
- 自动保存图像 -所有生成的图像与元数据一起保存到磁盘
- API请求日志记录 -调试日志保存到对话文件夹
先决条件
安装
-
克隆存储库：
git clone https://github.com/yourusername/imagegen-mcp.git cd imagegen-mcp -
安装依赖项：
bun install -
从获取API密钥 开放路由
配置
克劳德桌面（Windows）
添加到您的Claude桌面配置 %APPDATA%\Claude\claude_desktop_config.json:
{
"mcpServers": {
"imagegen": {
"command": "bun",
"args": ["run", "C:\\path\\to\\imagegen-mcp\\index.ts"],
"env": {
"OPENROUTER_API_KEY": "your-api-key-here"
}
}
}
}
克劳德桌面（带WSL2的Windows）
如果通过WSL运行Bun：
{
"mcpServers": {
"imagegen": {
"command": "wsl",
"args": ["bun", "run", "/home/user/projects/imagegen-mcp/index.ts"],
"env": {
"OPENROUTER_API_KEY": "your-api-key-here"
}
}
}
}
克劳德桌面（macOS/Linux）
{
"mcpServers": {
"imagegen": {
"command": "bun",
"args": ["run", "/path/to/imagegen-mcp/index.ts"],
"env": {
"OPENROUTER_API_KEY": "your-api-key-here"
}
}
}
}
用法
配置后，以下工具在Claude中可用：
generate_image
根据文本提示创建新图像。
例子： “生成一只猫坐在彩虹上的图像”
edit_image
使用自然语言指令修改现有图像。模型接收之前的图像，并尝试仅进行所请求的更改。
例子： “让猫的皮毛变成橙色”或“给猫戴墨镜”
handle_generated_image
在系统的默认图像查看器中打开生成的图像。生成后自动调用。
list_conversations
查看所有保存的图像生成对话及其ID和描述。
clear_conversation
从磁盘中删除特定对话或所有对话。
运作原理
- 图像生成：提示通过OpenRouter发送到Gemini Flash图像预览
- 图像编辑：前一张图片与编辑说明一起发送，以获得更好的结果
- 持久性：图像保存到
images/{conversation_id}/随着messages.json跟踪历史记录 - 日志记录：记录到的API请求/响应
request-{timestamp}.json用于调试
文件结构
imagegen-mcp/
├── index.ts # Main MCP server
├── images/ # Generated images and conversation data
│ └── {conv-id}/
│ ├── *.png # Generated images
│ ├── messages.json # Conversation history
│ ├── README.md # Conversation summary
│ └── request-*.json # API logs
├── package.json
└── tsconfig.json
发展
直接运行服务器：
OPENROUTER_API_KEY=your-key bun run index.ts
许可证
麻省理工学院
