Promptshopmcp

An image processing server based on the MCP protocol that realizes professional - level image editing functions through natural language instructions

Image and video processing Developer tools #Image generation #Intelligent photo retouching #AI design #Background removal .Python

rating : 2 points

downloads : 7.1K

update time : 2025-04-28

Open Site

What is PromptShopMCP?

PromptShopMCP is an MCP server based on the Google Gemini model. It allows users to generate or modify images through natural language descriptions. Whether you are a designer or an ordinary user, you can easily create or adjust images.

How to use PromptShopMCP?

Simply enter your requirements (e.g., 'Add a coat to this dog'), and PromptShopMCP will automatically process the image according to your description.

Applicable scenarios

Suitable for scenarios that require rapid image generation or editing, such as social media content creation, advertising design, personal projects, etc.

Main features

Image generation

Utilize the Google Gemini model to generate brand - new images based on text prompts.

Image modification

Perform text - driven modification operations on existing images, such as adding elements or adjusting styles.

Background removal

Easily remove the background of an image using the remove.bg API.

Image hosting

Share generated images through FreeImage.host.

Resource management

Track and manage generated and uploaded images.

Advantages

Easy to use. You can complete image editing tasks without complex skills.

Supports a variety of advanced functions, such as background removal and custom generation.

Powerful API integration ensures an efficient workflow.

Limitations

An effective API key is required to run some advanced functions.

It has certain requirements for the network environment. In particular, the image processing speed may be affected by the bandwidth.

How to use

Install the server

Clone the repository and install the dependencies according to the instructions.

Configure the API key

Set the API keys for Google Gemini, FreeImage.host, and remove.bg in the environment variables.

Start the server

Run the Python script to start the PromptShopMCP service.

Usage examples

Case 1: Add a coat

The original picture is of a dog, and the goal is to add a coat to it.

Case 2: Remove the background

The original picture contains a complex background, and the goal is to keep only the main subject.

Frequently Asked Questions

Is PromptShopMCP free to use?

How to obtain an API key?

Related resources

PromptShopMCP official documentation

Learn more about PromptShopMCP and its installation guide.

Google Gemini

Learn about the functions and services of Google Gemini.

remove.bg API

Obtain an API key for background removal.

🚀 PromptShopMCP

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

🚀 Quick Start

Prerequisites

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

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 | cscript /nologo $"

Run the server using UV:
```
# Use the UV tool
uv server
```

Usage

Configuration via Claude Desktop

Copy the following content in its entirety into the claudius.json file:

{
  "configuration": {
    "MCP.enabled": true,
    "MCP.apiUrl": "http://localhost:3000"
  }
}

Configuration via Command Line Interface (CLI)

Run the following command in the terminal to start the server:

uv server --port 3000

✨ Features

Image Generation: Generate images from text prompts using Google's Gemini model.
Image Modification: Transform existing images according to text instructions.
Background Removal: Remove the background of images via the remove.bg API.
Image Hosting: Share generated images through FreeImage.host.
Resource Management: Track and manage generated and uploaded images.