Ezkielyna Image

Ezkielyna Image MCP

一个 MCP 服务，让你的 AI 助手可以根据电脑上的文件创建和编辑图像：Claude Desktop、Claude Code、Cursor、OpenCode，或任何支持运行本地 stdio 服务的其他 MCP 客户端。图像通过 Ezkielyna API 生成。

示例：“我的产品照片是 ~/Shop/mug.jpg，徽标是 ~/Shop/logo.png。把徽标放到马克杯上，并将其保存为 mug-logo。”

🇮🇩 印度尼西亚语：请参阅下方章节。

• 单文件、无依赖项：只需 Node.js 18 或更高版本。无需运行 npm install。
• 参考图像来自本地文件（或 https 链接）；结果保存在本地。
• 结果可以再次编辑：助手只需传入先前结果的路径。
• 每个会话的付费调用次数有限制，不会打印 API 密钥，也不会覆盖现有文件。

npm： ezkielyna-image-mcp。你的应用可以通过 npx -y ezkielyna-image-mcp 启动它，无需克隆仓库。已列入官方 MCP 注册表，名称为 io.github.EzkielynaGroup/ezkielyna-image-mcp。

要求

1. Node.js 18+（node -v）。从 nodejs.org 获取 LTS 版本。
2. 一个属于 Media 组的 Ezkielyna API 密钥（Auto 组也包含图像模型）。在 ezkielyna.store 购买 API Credit（起价 $0.5，支持 QRIS/DANA/GoPay/USDT），在 api.ezkielyna.store 的 Wallet 中兑换，然后在 API Keys 下创建密钥。Standard/Premium 密钥无法使用图像模型。
3. 一定的余额。每张图像的价格可通过 list_image_models 工具以及 ezkielyna.store/models 查看。

安装

使用 npx（推荐）： 无需安装。以下配置会运行 npx -y ezkielyna-image-mcp，并在首次启动时下载软件包（单文件，无依赖项）。

从源码安装（用于阅读或修改代码）：

git clone https://github.com/EzkielynaGroup/ezkielyna-image-mcp.git
cd ezkielyna-image-mcp
node --test test/        # optional: runs against a local mock, no network, no cost
pwd                      # the full path of ezkielyna-image-mcp.mjs is <this folder>/ezkielyna-image-mcp.mjs

在 Windows 上，如果应用无法启动 npx，请使用 "command": "cmd"，并将 "args": ["/c", "npx", "-y", "ezkielyna-image-mcp"] 作为参数。若从源码安装，请在 JSON 中使用正斜杠编写路径（C:/Users/you/ezkielyna-image-mcp/ezkielyna-image-mcp.mjs），或使用双反斜杠。

配置（环境变量）

变量	必填	默认值	说明
EZKIELYNA_API_KEY	是		属于 Media 组（或 Auto 组）的密钥
EZKIELYNA_BASE_URL	否	https://api.ezkielyna.store/v1	API 地址
EZKIELYNA_IMAGE_DIR	否	~/Pictures/Ezkielyna	输出文件夹（不存在时会创建）
EZKIELYNA_MAX_IMAGES	否	30	每个会话的付费图像数量上限，用于防止循环失控。重启应用即可重置。
EZKIELYNA_TIMEOUT_MS	否	300000	请求超时时间

将其添加到你的应用

将 sk-... 替换为你的 Media 密钥。从源码安装的？请使用 "command": "node"，并将 "args": ["/path/to/ezkielyna-image-mcp.mjs"] 作为参数，而不是使用 npx。

Claude Desktop：依次打开 Settings → Developer → Edit Config（claude_desktop_config.json），然后完全退出并重新打开 Claude Desktop。

{
  "mcpServers": {
    "ezkielyna-image": {
      "command": "npx",
      "args": ["-y", "ezkielyna-image-mcp"],
      "env": { "EZKIELYNA_API_KEY": "sk-..." }
    }
  }
}

Claude Code

claude mcp add ezkielyna-image -e EZKIELYNA_API_KEY=sk-... -- npx -y ezkielyna-image-mcp

添加 --scope user，即可在每个项目中使用。使用 claude mcp list 检查。

Cursor：~/.cursor/mcp.json（所有项目）或 .cursor/mcp.json（单个项目），使用与 Claude Desktop 相同的 JSON。

OpenCode：项目中的 opencode.json，或供所有项目使用的 ~/.config/opencode/opencode.json。

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "ezkielyna-image": {
      "type": "local",
      "command": ["npx", "-y", "ezkielyna-image-mcp"],
      "enabled": true,
      "environment": { "EZKIELYNA_API_KEY": "sk-..." }
    }
  }
}

工具

工具	功能	费用
generate_image	根据文本生成新图像。选项：model（默认值为 gpt-image-2.5）、size（例如 1024x1024）、filename。	按图像计费
edit_image	编辑或组合 1–4 张图像（本地路径或 https 链接）。选项：model、quality（仅限 gpt-image）、size、filename。	按图像计费
list_image_models	查看 API 密钥可用的图像模型、每张图像的价格，以及哪些模型支持编辑。	免费

编辑模型：gpt-image-2.5（默认值，最多支持 4 张参考图，适合制作 Logo 和背景）和 nano-banana-pro（最多支持 4 张参考图，细节丰富，价格更高）。上传文件总大小请控制在约 30 MB 以内（nano-banana-pro 约为 22 MB，因为图像会以 base64 格式发送）；大型手机照片请先调整大小，转换为约 2000 px 的 JPEG。

每个结果都包含文件路径、模型和价格；图像大小不超过 3.5 MB 时，也会直接显示在结果中。

安全

• 只读取内容确实为图像的 .png、.jpg、.jpeg、.webp 文件，大小上限为 20 MB；链接必须使用 https。
• 只会在输出文件夹内写入文件，会清理文件名，且不会覆盖已有文件（name-1.png、name-2.png……）。
• 每条答复和日志中都会清除 API 密钥。日志输出到 stderr；stdout 仅包含 MCP 消息。
• EZKIELYNA_MAX_IMAGES 限制每个会话中的付费调用次数。

其他提供商

此服务基于 Ezkielyna API 构建。EZKIELYNA_BASE_URL 可以指向其他与 OpenAI 兼容的端点，只要该端点通过 /v1/images/generations 和 /v1/images/edits 提供相同名称的图像模型即可；但在这些端点上不会显示每张图像的价格。

开发

node --test test/

测试会通过 stdio 启动服务，并连接本地模拟网关：无需联网，也不会产生费用。欢迎提交问题和拉取请求。

---

印度尼西亚语

用于通过 AI 助手（Claude Desktop、Claude Code、Cursor、OpenCode）从电脑上的文件创建和编辑图像的 MCP 服务。例如：“将 Logo ~/Toko/logo.png 贴到照片 ~/Toko/kaos.jpg 左胸位置，并保存为 kaos-logo。”

• 只需 Node.js 18+。可通过 npm 获取：应用会使用 npx -y ezkielyna-image-mcp 运行，无需克隆。也可以从源码运行（git clone，参见上文）。
• 需要 Ezkielyna API 的 Media 组 API 密钥（或 Auto）。可通过 QRIS/DANA/GoPay 充值，最低 $0.5：ezkielyna.store/beli-api-key。
• 各应用的配置与上方示例相同，只需替换 sk-...。
• 完整的印度尼西亚语指南：ezkielyna.store/panduan/mcp-gambar。

许可证

MIT。Ezkielyna 是独立的 API 网关，与模型供应商或 MCP 客户端开发者均无关联。