Promptshop

An image processing server based on the MCP protocol that enables professional - level image editing functions through natural language instructions, including generation, modification, background removal, and hosting services.

Image and video processing Developer tools #Image Generation #Image Editing #AI Image Retouching #Background Removal .Python

rating : 2.5 points

downloads : 7.3K

update time : 2025-04-23

Open Site

What is PromptShopMCP?

PromptShopMCP is a server based on the Model Context Protocol (MCP) that allows users to generate or modify images through simple text descriptions. Whether you're a design novice or a professional, you can easily achieve complex image processing.

How to use PromptShopMCP?

You can start using PromptShopMCP in just a few steps. First, install and configure the server. Then, enter your text instructions, and the server will automatically process and return the results.

Applicable Scenarios

PromptShopMCP is very suitable for design projects, personal creations, and commercial uses that require rapid generation of high - quality images. Whether it's adding clothing, changing the background, or other creative needs, PromptShopMCP can meet your requirements.

Main Features

Image Generation

Generate brand - new images based on text descriptions using the Google Gemini model.

Image Modification

Adjust existing images, such as adding elements and changing colors.

Background Removal

Remove the image background through the remove.bg API.

Image Hosting

Host the generated images for free through FreeImage.host.

Resource Management

Track and manage generated and uploaded images.

Advantages

Easy to use: Complete complex tasks by simply entering text instructions.

High efficiency: Significantly reduce manual operation time.

Multi - platform support: Compatible with multiple operating systems.

High - quality output: Ensure image quality with advanced AI technology.

Limitations

Dependent on API keys: Need to register for multiple third - party services.

High network environment requirements: Require a stable Internet connection.

How to Use

Install the Server

Clone the repository and install the necessary dependencies.

Configure API Keys

Fill in the API keys of Google Gemini, remove.bg, and FreeImage.host in the server configuration file.

Start the Server

Run the script to start the MCP server.

Usage Examples

Case 1: Add a Coat

Pass the text instruction 'add a coat to the dog' to the server to generate an image of a dog with a coat.

Case 2: Replace the Background

Use the instruction'replace background' to replace the image background.

Frequently Asked Questions

Is PromptShopMCP free to use?

How to obtain API keys?

Which operating systems does PromptShopMCP support?

Related Resources

PromptShopMCP GitHub

Visit the official GitHub repository of PromptShopMCP.

Google Gemini

Learn about the powerful features of Google Gemini.

remove.bg

Try the online background removal tool.

🚀 MCP Image Tool Server (PromptShopMCP)

A powerful MCP (Model Context Protocol) server that can transform images through simple text commands. Edit photos like a professional designer - just describe the effects you want in natural language!

English | Chinese

🚀 Quick Start

A powerful MCP (Model Context Protocol) server that enables image transformation through simple text commands. Edit photos like a pro—simply describe the desired effects in natural language!

💻 Usage Examples

Basic Usage

Original Image

Prompt: Add a coat to the dog

Prompt: Then put a hat on it

✨ Features

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

📦 Installation

Configuration 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

Steps

Clone this repository:

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

Install UV (if not already installed):

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

Install dependencies using UV:

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

📚 Documentation

Usage Instructions

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"
  }
}