Image Toolkit MCP Server

by Kira-Pgr

18 stars
281 downloads
Not rated
GitHub

About

Use AI to edit image in Claude Desktop / Cursor (AI P图)

Details

Author
Kira-Pgr
GitHub stars
18
Downloads
281
Categories
Developer Tools

- Image generation from text prompts using Google Gemini
- Image modification based on text instructions
- Background removal via Remove.bg API
- Image hosting through FreeImage.host
- Resource management for generated and uploaded images

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Image Toolkit MCP Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install by cloning the repository, setting up a Python 3.11+ virtual environment with UV, and installing dependencies. Configure three API keys (Gemini, FreeImage.host, Remove.bg) and integrate with Claude Desktop or Cursor via JSON config or shell scripts.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "image toolkit mcp server": {
            "Image-Toolkit-MCP-Server": {
                "command": "uv",
                "args": [
                    "venv",
                    "--python=python3.11"
                ]
            }
        }
    }
}

McpServers

{
    "Image-Toolkit-MCP-Server": {
        "command": "uv",
        "args": [
            "venv",
            "--python=python3.11"
        ]
    }
}

PromptShopMCP

![](https://badge.mcpx.dev?type=server 'MCP Server')

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

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

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.