Skip to main content
Glama

OpenRouter Image MCP Server

by WeiYu021

OpenRouter Image MCP Server 🖼️

🤖 A Model Context Protocol (MCP) server for generating and editing images using OpenRouter's API with Gemini 2.5 Flash Image model.

一个用于通过 OpenRouter API 生成和编辑图像的 Model Context Protocol (MCP) 服务器,支持自定义图像尺寸比例。

✨ 特性

  • 🎨 生成图像: 从文本描述创建全新的图像

  • ✏️ 编辑图像: 使用文本提示修改现有图像

  • 🔄 迭代编辑: 持续编辑上次生成/编辑的图像

  • 📐 自定义尺寸: 支持多种图像宽高比(1:1, 16:9, 9:16, 等)

  • 🖼️ 多参考图像: 使用参考图像进行风格迁移和引导

  • 🌍 跨平台: 支持 Windows、macOS 和 Linux 的智能文件路径

  • 🔧 简单配置: 使用 API 密钥轻松配置

  • 📁 自动文件管理: 自动保存图像并组织命名

🔑 获取 API 密钥

  1. 访问 OpenRouter Settings - Keys

  2. 创建一个新的 API 密钥

  3. 复制密钥用于配置

💻 使用方法

在 Claude Desktop 中使用

配置方法:

在 Claude Desktop 的 MCP 配置中添加:

方法 A:使用环境变量(推荐 - 最安全)

{ "mcpServers": { "openrouter-image": { "command": "npx", "args": ["openrouter-image-mcp"], "env": { "OPENROUTER_API_KEY": "your-openrouter-api-key-here" } } } }

方法 B:不使用环境变量

{ "mcpServers": { "openrouter-image": { "command": "npx", "args": ["openrouter-image-mcp"] } } }

使用示例:

生成一张日落山景图像
将这张图像编辑成添加一些飞鸟
继续编辑,让它更加戏剧化
生成一张 16:9 比例的未来城市图像

🎯 在 Cursor 中使用

配置方法:

在 Cursor 的 MCP 配置中添加:

方法 A:使用环境变量(推荐)

{ "openrouter-image": { "command": "node", "args": ["E:\\Study\\赚钱\\工具\\Openrouter-Image-MCP\\dist\\index.js"], "env": { "OPENROUTER_API_KEY": "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" } } }

方法 B:不使用环境变量

{ "openrouter-image": { "command": "npx", "args": ["openrouter-image-mcp"] } }

使用示例:

  • 让 Cursor 为你的应用生成图像

  • 创建模型和原型

  • 为项目生成资源

🔧 在其他 MCP 客户端中使用

如果你使用其他 MCP 客户端,可以使用以下任一配置方法:

配置方法

方法 A:MCP 配置中的环境变量(推荐)

{ "openrouter-image": { "command": "npx", "args": ["openrouter-image-mcp"], "env": { "OPENROUTER_API_KEY": "your-openrouter-api-key-here" } } }

方法 B:系统环境变量

export OPENROUTER_API_KEY="your-openrouter-api-key-here" npx openrouter-image-mcp

方法 C:使用配置工具

npx openrouter-image-mcp # 服务器会在首次使用时提示你配置 # 这会在当前目录创建 .openrouter-image-config.json 文件

🛠️ 可用命令

generate_image

从文本提示创建新图像。

generate_image({ prompt: "A futuristic city at night with neon lights", aspectRatio: "16:9" // 可选 })

支持的宽高比:

  • 1:1 → 1024×1024(默认)

  • 16:9 → 1344×768

  • 9:16 → 768×1344

  • 3:4 → 864×1184

  • 4:3 → 1184×864

  • 2:3 → 832×1248

  • 3:2 → 1248×832

  • 4:5 → 896×1152

  • 5:4 → 1152×896

  • 21:9 → 1536×672

edit_image

编辑特定的图像文件。

edit_image({ imagePath: "/path/to/image.png", prompt: "Add a rainbow in the sky", referenceImages: ["/path/to/reference.jpg"], // 可选 aspectRatio: "16:9" // 可选 })

continue_editing

继续编辑上次生成/编辑的图像。

continue_editing({ prompt: "Make it more colorful", referenceImages: ["/path/to/style.jpg"], // 可选 aspectRatio: "1:1" // 可选 })

get_last_image_info

获取上次生成的图像信息。

get_last_image_info()

configure_openrouter_token

配置你的 OpenRouter API 密钥。

configure_openrouter_token({ apiKey: "your-openrouter-api-key" })

get_configuration_status

检查 API 密钥是否已配置。

get_configuration_status()

⚙️ 配置优先级

MCP 服务器按以下优先级顺序加载你的 API 密钥:

  1. 🥇 MCP 配置环境变量(最高优先级)

    • 在 MCP 客户端配置中设置

    • 最安全,因为包含在 MCP 配置中

    • 示例:"env": { "OPENROUTER_API_KEY": "your-key" }

  2. 🥈 系统环境变量

    • 在 shell/系统环境中设置

    • 示例:export OPENROUTER_API_KEY="your-key"

  3. 🥉 本地配置文件(最低优先级)

    • 使用 configure_openrouter_token 工具时创建

    • 作为 .openrouter-image-config.json 存储在当前目录

    • 自动被 Git 和 NPM 忽略

💡 推荐: 使用方法 1(MCP 配置环境变量)以获得最佳安全性和便利性。

📁 文件存储

图像自动保存到适合平台的位置:

  • Windows: %USERPROFILE%\\Documents\\openrouter-images\\

  • macOS/Linux: ./generated_imgs/(在当前目录)

  • 系统目录: ~/openrouter-images/(从系统路径运行时)

文件命名规范:

  • 生成的图像:generated-[timestamp]-[id].png

  • 编辑的图像:edited-[timestamp]-[id].png

🎨 示例工作流程

基本图像生成

  1. generate_image - 创建你的基础图像

  2. continue_editing - 优化和改进

  3. continue_editing - 添加最后的润色

风格迁移

  1. generate_image - 创建基础内容

  2. edit_image - 使用参考图像应用风格

  3. continue_editing - 微调结果

迭代设计

  1. generate_image - 从概念开始

  2. get_last_image_info - 检查当前状态

  3. continue_editing - 进行调整

  4. 重复直到满意

自定义尺寸

  1. generate_image - 使用 aspectRatio: "16:9" 创建宽屏图像

  2. continue_editing - 使用 aspectRatio: "9:16" 调整为竖屏

  3. edit_image - 使用不同比例创建变体

🔧 开发

本地开发

# 克隆仓库 git clone https://github.com/yourusername/openrouter-image-mcp.git cd openrouter-image-mcp # 安装依赖 npm install # 开发模式运行 npm run dev # 生产构建 npm run build # 运行测试 npm test

技术栈

  • TypeScript - 类型安全开发

  • Node.js - 运行时环境

  • Zod - 模式验证

  • OpenAI SDK - OpenRouter API 客户端

  • MCP SDK - Model Context Protocol

📋 要求

  • Node.js 18.0.0 或更高版本

  • 来自 OpenRouter 的 API 密钥

  • 兼容 Claude Desktop、Cursor 和其他 MCP 客户端

🤝 贡献

欢迎贡献!请随时:

  • 报告 bug

  • 建议新功能

  • 提交 pull request

  • 改进文档

📄 许可证

MIT 许可证 - 详见 LICENSE 文件。

🙏 致谢

📞 支持

🔗 链接


✨ 通过 OpenRouter 和 MCP 协议实现强大的 AI 图像生成功能!

Deploy Server
A
security – no known vulnerabilities
-
license - not tested
A
quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Enables generating and editing images using OpenRouter's API with Gemini 2.5 Flash Image model. Supports custom aspect ratios, iterative editing, and reference images for style transfer.

  1. ✨ 特性
    1. 🔑 获取 API 密钥
      1. 💻 使用方法
        1. 在 Claude Desktop 中使用
      2. 🎯 在 Cursor 中使用
        1. 配置方法:
        2. 使用示例:
      3. 🔧 在其他 MCP 客户端中使用
        1. 配置方法
      4. 🛠️ 可用命令
        1. generate_image
        2. edit_image
        3. continue_editing
        4. get_last_image_info
        5. configure_openrouter_token
        6. get_configuration_status
      5. ⚙️ 配置优先级
        1. 📁 文件存储
          1. 🎨 示例工作流程
            1. 基本图像生成
            2. 风格迁移
            3. 迭代设计
            4. 自定义尺寸
          2. 🔧 开发
            1. 本地开发
            2. 技术栈
          3. 📋 要求
            1. 🤝 贡献
              1. 📄 许可证
                1. 🙏 致谢
                  1. 📞 支持
                    1. 🔗 链接

                      MCP directory API

                      We provide all the information about MCP servers via our MCP API.

                      curl -X GET 'https://glama.ai/api/mcp/v1/servers/WeiYu021/openrouter-image-MCP'

                      If you have feedback or need assistance with the MCP directory API, please join our Discord server