PromptShopMCP 使用说明

项目简介

PromptShopMCP 是一个基于 Model Context Protocol (MCP) 构建的图像处理服务器。它允许用户通过自然语言文本指令，利用 Google Gemini 模型进行图像生成和编辑，并集成了背景移除和图像托管等功能。您可以像专业设计师一样，仅通过描述即可修改和创作图像。

主要功能点

文本生成图像: 使用 Google Gemini 模型，根据文本提示词创建全新的图像。
图像编辑: 根据文本指令修改现有图像，例如添加、移除或更改图像中的元素。
背景移除: 利用 remove.bg API，快速去除图像背景。
图像托管: 通过 FreeImage.host 服务，方便地分享生成的图像。
资源管理: 跟踪和管理已生成和上传的图像资源。

安装步骤

克隆仓库

git clone https://github.com/Kira-Pgr/PromptShopMCP.git
cd PromptShopMCP

安装 UV (可选，推荐使用)

# 按照仓库 README.md 的指引安装 UV，或者直接使用 pip
pip install uv

创建虚拟环境并安装依赖

uv venv --python=python3.11  # 推荐使用 Python 3.11 或更高版本
source .venv/bin/activate   # Linux/macOS
.venv/Scripts/activate.bat  # Windows
uv pip install -r requirements.txt

配置 API 密钥 您需要以下 API 密钥，并将其设置为环境变量：

'GEMINI_API_KEY': Google Gemini API 密钥 (获取密钥)
'FREEIMAGE_API_KEY': FreeImage.host API 密钥 (获取密钥)
'REMOVEBG_API_KEY': remove.bg API 密钥 (获取密钥)

例如，在 Linux/macOS 中，您可以在终端中使用 'export' 命令设置环境变量：

export GEMINI_API_KEY=YOUR_GEMINI_API_KEY
export FREEIMAGE_API_KEY=YOUR_FREEIMAGE_API_KEY
export REMOVEBG_API_KEY=YOUR_REMOVEBG_API_KEY

在 Windows 中，可以使用 'set' 命令：

set GEMINI_API_KEY=YOUR_GEMINI_API_KEY
set FREEIMAGE_API_KEY=YOUR_FREEIMAGE_API_KEY
set REMOVEBG_API_KEY=YOUR_REMOVEBG_API_KEY

服务器配置 (Claude Desktop 客户端)

要将 PromptShopMCP 服务器集成到 Claude Desktop 客户端，您需要在 Claude Desktop 的配置文件 'claude_desktop_config.json' 中添加以下配置。请根据您的实际项目路径和 API 密钥进行修改：

{
  "PromptShopMCP": {  // 服务器名称，可以自定义
    "command": "uv",  // 启动命令，这里使用 uv 运行 Python 脚本
    "args": [         // 启动参数
      "--directory",  // 指定工作目录
      "/project/dir/", //  请替换为您的 PromptShopMCP 项目的绝对路径
      "run",          // uv run 命令
      "mcp",          // uv run mcp 命令，表示运行 mcp 模块
      "run",          // mcp 模块的 run 命令
      "/project/dir/server.py" // 请替换为您的 server.py 脚本的绝对路径
    ],
    "env": {           // 环境变量
      "GEMINI_API_KEY": "YOUR_GEMINI_API_KEY",      // 请替换为您的 Gemini API 密钥
      "FREEIMAGE_API_KEY": "YOUR_FREEIMAGE_API_KEY",  // 请替换为您的 FreeImage.host API 密钥
      "REMOVEBG_API_KEY": "YOUR_REMOVEBG_API_KEY"   // 请替换为您的 remove.bg API 密钥
    }
  }
}

注意:

请将 '/project/dir/' 替换为 PromptShopMCP 项目在您本地机器上的绝对路径。
请将 '"YOUR_GEMINI_API_KEY"'、'"YOUR_FREEIMAGE_API_KEY"'、'"YOUR_REMOVEBG_API_KEY"' 替换为您实际获取的 API 密钥。
确保您已经正确安装了 UV 或 pip，并创建了虚拟环境和安装了依赖。

基本使用方法

启动 PromptShopMCP 服务器 (通过 Claude Desktop 或 Cursor 等 MCP 客户端配置启动)。
在 MCP 客户端中，可以使用自然语言指令调用 PromptShopMCP 提供的工具，例如：
- 使用 'generate_image_from_text' 工具，根据文本描述生成图像。
- 使用 'generate_image_from_url' 工具，修改指定 URL 的图像。
- 使用 'remove_background' 工具，移除指定 URL 图像的背景。
服务器会将处理后的图像上传到 FreeImage.host，并返回图像的 URL。您可以将 URL 嵌入到 Markdown 文本中使用，例如 ''。

示例: 在 Claude Desktop 或 Cursor 中，您可以输入类似以下的指令： '请帮我把这张图片 [图片URL] 上的狗添加一顶帽子。' 客户端会将指令发送给 PromptShopMCP 服务器，服务器调用 'generate_image_from_url' 工具处理图像，并将结果图像的 URL 返回给客户端。

关键词