MCP Image Gen

🚀 圖像生成器 MCP 服務器

圖像生成器 MCP 服務器藉助 Replicate 實現圖像生成功能，用戶不僅能生成圖像，還可將其保存下來，滿足多樣化的圖像使用需求。

🚀 快速開始

安裝

Replicate API Token

若要使用此圖像生成器，您需獲取一個 Replicate API Token，具體步驟如下：

1. 在 Replicate 創建賬戶。
2. 從 https://replicate.com/account 獲取您的 API Token。
3. 依據提供的 .env.example 模板創建一個 .env 文件：

REPLICATE_API_TOKEN=your_replicate_api_token_here

⚠️ 重要提示

.env 文件通過 .gitignore 排除在版本控制之外，以防止意外暴露您的 API Token。絕不要將敏感信息提交到您的倉庫。

環境設置

1. 克隆倉庫：

git clone https://github.com/yourusername/image-generator.git
cd image-generator

2. 創建並激活虛擬環境：

# 使用 venv
python -m venv .venv
# 在 Windows 上
.venv\Scripts\activate
# 在 macOS/Linux 上
source .venv/bin/activate

3. 安裝依賴項：

pip install -r requirements.txt

4. 按照上述說明設置您的 .env 文件

Claude Desktop

• 在 MacOS 上：~/Library/Application\ Support/Claude/claude_desktop_config.json
• 在 Windows 上：%APPDATA%/Claude/claude_desktop_config.json%

使用方法

一旦服務器運行，您可以按以下步驟操作：

1. 使用 "generate-image" 工具和一個描述性的提示詞生成圖像。
2. 使用 "save-image" 工具和圖像 URL 及提示詞保存生成的圖像。
3. 使用 "list-saved-images" 工具查看所有已保存的圖像。
4. 通過資源列表訪問已保存的圖像。

✨ 主要特性

組件

資源

該服務器實現了一個圖像存儲系統，具備以下功能：

• 使用自定義 image:// URI 方案訪問單個生成圖像。
• 每個圖像資源都有基於其提示詞的名稱、包含創建日期的描述以及 image/png 媒體類型。

提示詞

服務器提供一個單一的提示詞：

• generate-image：用於使用 Stable Diffusion 生成圖像。
  • 可選 "style" 參數來控制圖像風格（現實主義/藝術/抽象）。
  • 根據風格生成帶有指導語句的提示詞模板。

工具

該服務器實現了三個工具：

• generate-image：使用 Replicate 的 Stable Diffusion 模型生成圖像。
  • 接受 "prompt" 作為必需的字符串參數。
  • 可選參數包括 "negative_prompt"、"width"、"height"、"num_inference_steps" 和 "guidance_scale"。
  • 返回生成的圖像及其 URL。
• save-image：將生成的圖像保存到本地文件系統。
  • 接受 "image_url" 和 "prompt" 作為必需的字符串參數。
  • 為圖像生成唯一 ID 並將其保存到 "generated_images" 目錄。
• list-saved-images：列出所有已保存的圖像。
  • 返回所有已保存圖像及其元數據和縮略圖的列表。

📦 安裝指南

構建與發佈

要準備分發包，可按以下步驟操作：

1. 同步依賴項並更新鎖文件：

uv sync

2. 構建包發行版本：

uv build

這將在 dist/ 目錄中創建源代碼和輪發行。 3. 發佈到 PyPI：

uv publish

注意：您需要通過環境變量或命令行參數設置 PyPI 憑據：

• Token：--token 或 REPOSITORY_TOKEN。
• 倉庫 URL：--repository-url（默認為 https://upload.pypi.org/）。

調試

要調試圖像生成器，可按以下步驟操作：

1. 在終端中運行服務器。
2. 打開 http://localhost:8000 訪問 MCP 儀表板。
3. 使用 "image-generator" 服務進行交互。