License

Skip to content

You signed in with another tab or window. Reload
to refresh your session. You signed out in another tab or window. Reload
to refresh your session. You switched accounts on another tab or window. Reload
to refresh your session. Dismiss alert

Kira-Pgr / PromptShopMCP Public

• Notifications
  You must be signed in to change notification settings

• Fork 3

• Star 6

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

License

MIT license

6 stars
3 forks
Branches
Tags
Activity

Star

Notifications
You must be signed in to change notification settings

Kira-Pgr/PromptShopMCP

main

1 Branch
0 Tags

Go to file

Code

Folders and files

| Name | | Name | Last commit message | Last commit date |
| --- | --- | --- | --- |
| Latest commit
-------------


Kira-Pgr

Update pylint.yml

Mar 19, 2025

5bc0cd1
 · Mar 19, 2025

History
-------

30 Commits

| | |
| .github/workflows | | .github/workflows | Update pylint.yml | Mar 19, 2025 |
| .gitignore | | .gitignore | update gitignore | Mar 16, 2025 |
| LICENSE | | LICENSE | Create LICENSE | Mar 15, 2025 |
| README.md | | README.md | Update README.md | Mar 17, 2025 |
| README_ZH.md | | README_ZH.md | Fix Format | Mar 18, 2025 |
| cursor-template.bat | | cursor-template.bat | add cursor-template for windows | Mar 16, 2025 |
| cursor.sh | | cursor.sh | Cursor Support | Mar 15, 2025 |
| requirements.txt | | requirements.txt | upload | Mar 15, 2025 |
| server.py | | server.py | fix linter errors | Mar 19, 2025 |
| View all files | | |

Repository files navigation

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:

  • Google Gemini API key Get key

  • FreeImage.host API key Get key

  • Remove.bg API key Get key

Installation

1. Clone this repository:

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

2. Install UV (if not already installed):

   ```shell

   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:

   shell 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:

   json "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.

2. In cursor settings, go to the "MCP" tab, click on Add new MCP server,

3. Name the server whatever you want, and set the command to sh /absolute/path/to/cursor.sh.
4. Wait for the server to start, and you can see the server and available tools.
5. Then when you use the agent, it would automatically detect whether use the tools.

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

About

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

Resources

Readme

License

MIT license

Activity

Stars

6 stars

Watchers

1 watching

Forks

3 forks

Report repository

Contributors 2

• 
  Kira-Pgr KiraIO

• 
  Jinzedev 槿泽

Languages

• Python 96.1%

• Batchfile 2.1%

• Shell 1.8%

You can’t perform that action at this time.