Assets Generation MCP Server

AI 图片生成 MCP 服务器，支持 OpenAI DALL-E 和 Google Gemini 双 provider，返回标准 MCP ImageContent。

特性

• 根据模型名自动选择 provider（OpenAI / Gemini）
• 图片以 MCP 标准 ImageContent 格式返回（{ type: "image", data, mimeType }），AI 客户端可直接使用
• 支持三种 transport：stdio（默认）、SSE、HTTP
• 支持自定义 API 代理地址（OPENAI_BASE_URL / GEMINI_BASE_URL）
• 未配置 API Key 的 provider 自动禁用，不影响另一个 provider 使用

快速开始

npm install
npm run build
cp .env.example .env  # 填入 API Key

环境变量

| 变量 | 必填 | 默认值 | 说明 | |------|------|--------|------| | GEMINI_API_KEY | 至少一个 | - | Google Gemini API Key | | OPENAI_API_KEY | 至少一个 | - | OpenAI API Key | | DEFAULT_MODEL | 否 | gemini-2.5-flash-image | 默认模型，工具调用时可覆盖 | | GEMINI_BASE_URL | 否 | - | Gemini API 代理地址 | | OPENAI_BASE_URL | 否 | - | OpenAI API 代理地址 | | MCP_TRANSPORT | 否 | stdio | 传输模式：stdio / sse / http | | MCP_HOST | 否 | localhost | SSE/HTTP 监听地址 | | MCP_PORT | 否 | 3000 | SSE/HTTP 监听端口 |

至少配置 GEMINI_API_KEY 或 OPENAI_API_KEY 其中一个，未配置的 provider 会自动禁用。

工具：generate_image

| 参数 | 必填 | 说明 | |------|------|------| | prompt | 是 | 图片描述 | | model | 否 | 模型名，默认 DEFAULT_MODEL 环境变量值 | | size | 否 | 图片尺寸（仅 OpenAI） | | quality | 否 | standard / hd（仅 DALL-E 3） | | n | 否 | 生成数量 | | aspect_ratio | 否 | 宽高比（仅 Gemini）：1:1 3:4 4:3 9:16 16:9 | | response_format | 否 | url / base64 / auto（默认） |

支持的模型：

• OpenAI: gpt-image-1, dall-e-3, dall-e-2
• Gemini: gemini-2.5-flash-image, gemini-2.0-flash-exp, imagen-3.0-generate-001

使用方式

Claude Desktop / Kiro（stdio 模式）

{
  "mcpServers": {
    "assets-gen": {
      "command": "node",
      "args": ["/path/to/assets-gen-mcp/dist/index.js"],
      "env": {
        "GEMINI_API_KEY": "your-key",
        "GEMINI_BASE_URL": "https://your-proxy.com"
      }
    }
  }
}

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

MCP SDK Client（编程接入）

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";

const transport = new StdioClientTransport({
  command: "node",
  args: ["dist/index.js"],
  env: { GEMINI_API_KEY: "your-key" },
});
const client = new Client({ name: "my-app", version: "1.0.0" }, { capabilities: {} });
await client.connect(transport);

const result = await client.callTool({
  name: "generate_image",
  arguments: { prompt: "A cat in space" },
});
// result.content → [{ type: "image", data: "<base64>", mimeType: "image/png" }]

SSE / HTTP 模式

MCP_TRANSPORT=sse MCP_PORT=3000 node dist/index.js

端点：

• GET /sse — SSE 连接
• POST /message?sessionId=xxx — 发送消息
• GET / — 健康检查

开发

npm run build             # 编译
npm run watch             # 监听编译
npm test                  # 单元测试（59 tests）
npm run test:integration  # 集成测试（11 tests，需要 API Key）
npm run models            # 列出可用 Gemini 模型

技术栈

• @modelcontextprotocol/sdk — MCP 服务端/客户端 SDK
• @google/genai — Google Gemini SDK（支持 baseUrl）
• openai — OpenAI SDK

License

MIT