🚀 图像生成器 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" 服务进行交互。