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 未刪除，其中的佔位符可能導致服務器啓動失敗。