Skip to main content

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:

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

Metadata

Release files for iflow-mcp_kira-pgr-promptshopmcp 0.1.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for iflow-mcp_kira-pgr-promptshopmcp 0.1.2
File Size Uploaded Provenance Actions
iflow_mcp_kira_pgr_promptshopmcp-0.1.2.tar.gz 11.9 kB Without provenance Details for iflow_mcp_kira_pgr_promptshopmcp-0.1.2.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for iflow-mcp_kira-pgr-promptshopmcp 0.1.2
File Interpreter ABI Platform Actions
iflow_mcp_kira_pgr_promptshopmcp-0.1.2-py3-none-any.whl Python 3 none any Details for iflow_mcp_kira_pgr_promptshopmcp-0.1.2-py3-none-any.whl

Total release size: 23.9 kB

Release files / iflow_mcp_kira_pgr_promptshopmcp-0.1.2.tar.gz

Download URL iflow_mcp_kira_pgr_promptshopmcp-0.1.2.tar.gz
Size 11.9 kB
Tags Source
SHA-256 checksum
How to use checksums
6ad14ff57dfe1d9e96a852ca8332229763f7b848988a92e39de1fbbf3f259454
BLAKE2b-256 checksum
How to use checksums
5a2e7c0c1d446c28c3a2b9481eb5097b05c8c78ff46690b98bb9993fa681fe5e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.10.0 {"installer":{"name":"uv","version":"0.10.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / iflow_mcp_kira_pgr_promptshopmcp-0.1.2-py3-none-any.whl

Download URL iflow_mcp_kira_pgr_promptshopmcp-0.1.2-py3-none-any.whl
Size 12.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
fede52cd03c1e6fcadd0c41a85520b52e4f666c349e6a11737e7e68f5ad91271
BLAKE2b-256 checksum
How to use checksums
f1d713ca08c762eb164efed60f324a7d917ed13000046765d0dd869e12e38a80
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.10.0 {"installer":{"name":"uv","version":"0.10.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Security for iflow-mcp_kira-pgr-promptshopmcp 0.1.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page