Introducing the mcp-simple-image Plugin

在 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 未删除,其中的占位符可能导致服务器启动失败。
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye