PromptShopMCP

English | 中文

A powerful MCP (Model Context Protocol) server that transforms images using simple text commands. Edit photos like a professional designer - just describe what you want in natural language!

Demo

Original Image

Prompt: add a coat to the dog

Prompt: Add a hat to it

Features

• Image Generation: Create images from text prompts using Google's Gemini models
• Image Modification: Transform existing images based on text instructions
• Background Removal: Remove backgrounds from images using the remove.bg API
• Image Hosting: Share generated images via FreeImage.host
• Resource Management: Track and manage generated and uploaded images

Requirements

• Python 3.11 or higher
• Required API keys:
• Google Gemini API key Get key
• FreeImage.host API key Get key
• Remove.bg API key Get key

Installation

1. Clone this repository:

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

2. Install UV (if not already installed):

   # 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. Install dependencies using UV:

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

Usage

1. Claude Desktop Integration: Add the following configuration to your claude_desktop_config.json file to run the server directly from 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"
     }
   }

   Note: Replace the placeholder "key" values with your actual API keys.
2. Cursor Integration:
   Linux/macOS: Modify the cursor.sh file to set your API keys and project directory.
3. In cursor settings, go to the "MCP" tab, click on Add new MCP server,
4. Name the server whatever you want, and set the command to sh /absolute/path/to/cursor.sh.
5. Wait for the server to start, and you can see the server and available tools.
6. Then when you use the agent, it would automatically detect whether use the tools.
   

Windows: Modify the cursor.bat file to set your API keys and project directory.
* In cursor settings, go to the "MCP" tab, click on Add new MCP server,
* Name the server whatever you want, and set the command to cmd /c C:absolutepath ocursor.bat.
* Wait for the server to start, and you can see the server and available tools.
* Then when you use the agent, it would automatically detect whether use the tools.

Acknowledgements

• Google Gemini: For the image generation capabilities
• Remove.bg: For background removal services
• FreeImage.host: For image hosting services
• MCP: For the Model Context Protocol