What is Promptshopmcp

PromptShopMCP is a powerful MCP (Model Context Protocol) server that allows users to edit images using simple text commands, enabling them to transform photos like professional designers.

Use cases

Use cases include adding elements to images, modifying existing photos, removing backgrounds, and creating unique visuals for promotional materials.

How to use

To use PromptShopMCP, clone the repository, install the necessary dependencies, and run the server. Users can then input natural language prompts to generate or modify images.

Key features

Key features include image generation from text prompts using Google’s Gemini models, image modification based on text instructions, background removal using the remove.bg API, image hosting via FreeImage.host, and resource management for tracking generated and uploaded images.

Where to use

PromptShopMCP can be used in various fields such as graphic design, marketing, social media content creation, and any area where image editing is required.

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:
   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.

• 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 sh /absolute/path/to/cursor.sh.
• 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.
  

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:\absolute\path\to\cursor.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