Openrouter Imagegen MCP

ImageGen MCP服务器

使用OpenRouter和Google Gemini生成和编辑AI图像的MCP（模型上下文协议）服务器。

特性

• 生成图像 使用Gemini Flash图像预览从文本提示中
• 编辑现有图像 使用自然语言指令（例如，“使天空变成橙色”）
• 对话持久性 -使用保存的对话历史记录从您中断的地方继续
• 自动保存图像 -所有生成的图像与元数据一起保存到磁盘
• API请求日志记录 -调试日志保存到对话文件夹

先决条件

• 包子 运行时（v1.0+）
• 开放路由 API密钥

安装

1. 克隆存储库：

   git clone https://github.com/yourusername/imagegen-mcp.git
   cd imagegen-mcp

1. 安装依赖项：

   bun install

1. 从获取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

从磁盘中删除特定对话或所有对话。

运作原理

1. 图像生成：提示通过OpenRouter发送到Gemini Flash图像预览
2. 图像编辑：前一张图片与编辑说明一起发送，以获得更好的结果
3. 持久性：图像保存到 images/{conversation_id}/ 随着 messages.json 跟踪历史记录
4. 日志记录：记录到的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

许可证

麻省理工学院