mcp-simple-image 插件介绍

在 DeepSeek Harness (DSH) 的插件化架构中，集成外部模型能力通常只需配置文件。mcp-simple-image 是一个 DSH 插件与 MCP 服务器，它通过 StepFun 兼容的 /images/generations 端点实现文本转图像功能。该插件不依赖第三方 SDK，仅使用 Python 标准库，且服务器随插件包一并分发，安装后无需额外编辑 MCP 服务器配置文件。

核心功能¶

插件注册了工具 mcp__simple_image__simple_image。该工具向 POST {STEP_API_BASE}/images/generations 发送请求，并将生成的图片 URL 作为文本返回。主要参数包括：
* prompt：必填，图片生成提示词。
* model：可选，模型 ID。
* size：可选，图片尺寸，默认为 1024x1024。
* n：可选，生成数量，范围为 1–4。

安装与启用¶

使用该插件前，需确保系统已安装 Python ≥ 3.8 并在 PATH 中。

通过 CLI 安装：

dsh plugin --profile web add bauerelizabeth07139/mcp-simple-image

通过 DSH Desktop 安装：

打开 DeepSeek Harness Desktop，进入侧边栏 Plugins -> Add plugin，输入仓库地址 https://github.com/bauerelizabeth07139/mcp-simple-image，然后启用新出现的插件。

配置¶

插件支持通过环境变量或 cordis.patch.yml 进行配置。config 中的配置优先级高于环境变量。

环境变量：
* STEP_API_KEY：API 密钥，必填。
* STEP_API_BASE：API 基础地址，需包含 /v1。
* STEP_MODEL：使用的模型 ID。

配置文件示例 (cordis.patch.yml)：

- id: dsh-simple-image
  name: 'dsh-simple-image'
  config:
    apiKey: 'sk-...'
    baseUrl: 'https://api.stepfun.com/step_plan/v1'
    model: 'step-image-edit-2'

注意事项¶

• Base URL 格式：baseUrl 必须已包含 /v1，插件会在此基础上追加 /images/generations。
• 返回结果：工具返回的是图片的 URL 链接，不是本地文件。由于请求中指定了 response_format: url，链接具有时效性，不会写入磁盘。
• 凭证优先级：如果 config.json 存在，其配置优先于环境变量；如果 config.example.json 未删除，其中的占位符可能导致服务器启动失败。