PromptShopMCP

English | 中文

一个强大的 MCP (模型上下文协议) 服务器，可以使用简单的文本命令转换图像。像专业设计师一样编辑照片 - 只需用自然语言描述你想要的内容！

演示

原始图像 <img src="https://github.com/user-attachments/assets/a987b4c4-3bba-4a52-a2a8-9f088868d857" width="300"/>

Prompt: 给狗加一件外套 <img src="https://github.com/user-attachments/assets/6de3cdd1-a3b9-422b-95dd-12e2172f6f1d" width="300"/>

Prompt: 给它加一顶帽子 <img src="https://github.com/user-attachments/assets/047289ca-f3d0-4d16-acf7-09d5af641c68" width="300"/>

功能

• 图像生成: 使用 Google 的 Gemini 模型从文本提示创建图像
• 图像修改: 根据文本指令转换现有图像
• 背景移除: 使用 remove.bg API 从图像中移除背景
• 图像托管: 通过 FreeImage.host 分享生成的图像
• 资源管理: 跟踪和管理生成和上传的图像

要求

• Python 3.11 或更高版本
• 必需的 API 密钥：
  • Google Gemini API 密钥 获取密钥
  • FreeImage.host API 密钥 获取密钥
  • Remove.bg API 密钥 获取密钥

安装

1. 克隆此仓库：

   git https://github.com/Kira-Pgr/Image-Toolkit-MCP-Server.git
   cd Image-Toolkit-MCP-Server
   

2. 安装 UV（如果尚未安装）：

   # On macOS and Linux.
   curl -LsSf https://astral.sh/uv/install.sh | sh
   # On Windows.
   powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
   # With pip.
   pip install uv
   

3. 使用 UV 安装依赖项：

   uv venv --python=python3.11
   source .venv/bin/activate #or .venv/Scripts/activate on Windows
   uv pip install -r requirements.txt
   

用法

1. Claude Desktop 集成: 将以下配置添加到你的 claude_desktop_config.json 文件，以直接从 Claude Desktop 运行服务器：

   "PromptShopMCP": {
     "command": "uv",
     "args": [
       "--directory",
       "/project/dir/",
       "run",
       "mcp",
       "run",
       "/project/dir/server.py"
     ],
     "env": {
       "GEMINI_API_KEY": "key",
       "FREEIMAGE_API_KEY": "key",
       "REMOVEBG_API_KEY": "key"
     }
   }
   

   注意：将占位符 "key" 值替换为你实际的 API 密钥。
2. Cursor 集成: Linux/macOS: 修改 cursor.sh 文件以设置你的 API 密钥和项目目录。

• 在 Cursor 设置中，转到 "MCP" 选项卡，点击 Add new MCP server，
• 随意命名服务器，并将命令设置为 sh /absolute/path/to/cursor.sh。
• 等待服务器启动，你就可以看到服务器和可用的工具。
• 然后，当你使用 agent 时，它会自动检测是否使用这些工具。 <img width="1240" alt="image" src="https://github.com/user-attachments/assets/b41016fe-a0f8-4029-8f5d-82f25c606a65" />

Windows: 修改 cursor.bat 文件以设置你的 API 密钥和项目目录。

• 在 Cursor 设置中，转到 "MCP" 选项卡，点击 Add new MCP server，
• 随意命名服务器，并将命令设置为 cmd /c C:\absolute\path\to\cursor.bat。
• 等待服务器启动，你就可以看到服务器和可用的工具。
• 然后，当你使用 agent 时，它会自动检测是否使用这些工具。

致谢

• Google Gemini: 用于图像生成功能
• Remove.bg: 用于背景移除服务
• FreeImage.host: 用于图像托管服务
• MCP: 用于模型上下文协议