dsh-mcp-server-image
其他 活跃维护

dsh-mcp-server-image

wyyxhn1314/dsh-mcp-server-image

stdio协议的通用MCP服务器,可对接任意符合OpenAI Images API规范的文生图端点,覆盖gpt-image、dall-e系列及各类兼容中转网关,将其封装为generate_系列MCP工具,方便MCP生态应用直接调用文生图能力。

0
Stars 标星
0
Forks 分支
0
Watchers 关注
0
Open Issues
JavaScript
主要语言
None
开源协议
6 KB
仓库大小
1 个月前
最后推送
一键安装扩展 / 插件指令
dsh plugin --profile web add github:wyyxhn1314/dsh-mcp-server-image
git clone https://github.com/wyyxhn1314/dsh-mcp-server-image.git
git clone git@github.com:wyyxhn1314/dsh-mcp-server-image.git
README.md master

dsh-mcp-server-image

通用 OpenAI 兼容文生图 MCP 服务器(stdio)。把任意 POST {baseURL}/images/generations
端点(OpenAI Images API 形态:gpt-image-*、dall-e-*,或任何兼容中转站/网关)
包装成一个 MCP 工具 generate_image,供 DeepSeek Harness
(或任何 MCP 客户端)调用。

零依赖:纯 Node(fetch)+ JSON-RPC 2.0 over stdio。

安装与使用(DeepSeek Harness)

DSH 通过官方 @deepseek-ai/dsh-mcp-client 桥接本服务器:

dsh plugin --profile web add @deepseek-ai/dsh-mcp-client

在你的 profile cordis.patch.yml 追加一个实例(密钥走环境变量,不落盘配置):

- insert:
    - id: mcp-image
      name: '@deepseek-ai/dsh-mcp-client'
      config:
        serverName: image
        transport: stdio
        command: npx
        args:
          - '-y'
          - 'dsh-mcp-server-image'
          - '--base-url'
          - 'https://api.openai.com/v1'
          - '--model'
          - 'gpt-image-1'
        env:
          IMAGE_API_KEY: !!js process.env.IMAGE_API_KEY

然后模型就获得 mcp__image__generate_image 工具,对模型说「生成一张 xxx 的图片」即可。
生成的 https 图片 URL 直接以 markdown ![alt](https://cdnimage-cache.doubi.ren/?url=https://raw.githubusercontent.com/wyyxhn1314/dsh-mcp-server-image/master/url) 渲染在聊天里;同时默认在
$DSH_HOME/generated/ 保存持久副本(URL 可能有时效)。

参数

参数 默认 说明
--base-url https://api.openai.com/v1 OpenAI 兼容 base URL(不含 /images/generations)
--model gpt-image-1 生图模型 id(如 gpt-image-2、dall-e-3)
--key-env IMAGE_API_KEY 存放 API key 的环境变量名
--out-dir $DSH_HOME/generated 或 ./generated 持久副本目录
--no-save — 不下载持久副本

工具入参:prompt(必填)、size(1024x1024 / 1024x1536 / 1536x1024 / 512x512 / auto)、
n(1–4)、save(默认 true)。

网络与代理

直连可用时无需任何设置。若你的网络需要代理(如国内访问外网),按 Node 标准
环境代理机制配置:

env:
  NODE_USE_ENV_PROXY: '1'
  HTTPS_PROXY: 'http://127.0.0.1:7890'
  HTTP_PROXY: 'http://127.0.0.1:7890'

行为细节

  • 请求默认带 response_format: "url";端点不支持时自动回退(不带该字段重试),
    并在仅有 b64_json 时解码落盘。
  • API key 只从环境变量读取,绝不进入任何配置文件。
  • 图片默认落盘 $DSH_HOME/generated/(.png/.jpg/.webp 按内容类型识别)。
  • 超时:生图请求 180s,副本下载 60s。

独立使用(任意 MCP 客户端)

IMAGE_API_KEY=sk-xxx npx -y dsh-mcp-server-image \
  --base-url https://api.openai.com/v1 --model gpt-image-1

许可

MIT