Image Toolkit

🚀 PromptShopMCP

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

English | Chinese

🚀 Quick Start

A powerful MCP (Model Context Protocol) server that enables image - to - image conversion using simple text commands. Edit photos like a pro, simply describe what you want in natural language!

✨ Features

• Image Generation: Create images from text prompts using Google's Gemini model.
• Image Modification: Transform existing images according to 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

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

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"
   # Using 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 Examples

Basic Usage

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

⚠️ Important Note

Replace the placeholder "key" values with your actual API keys.

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 and click Add new MCP server.
• Name the server whatever you like and set the command to sh /absolute/path/to/cursor.sh.
• After waiting for the server to start, you can see the server and tools in the available tools.
• Then, when using the proxy, it will automatically detect whether to use the tools.

📚 Documentation

Examples

Original Image

Prompt: add a coat to the dog

Prompt: Add a hat to it

📄 License

This section is not provided in the original README, so it is skipped.

🔗 Acknowledgments

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