Image Toolkit MCP Server

PromptShopMCP

English | 中文

一款强大的 MCP（Model Context Protocol）服务，可通过简单的文本命令转换图像。像专业设计师一样编辑照片——只需用自然语言描述你的需求！

演示

原始图像

提示词：给狗狗穿件外套

提示词：给它戴顶帽子

功能

• 图像生成：使用 Google Gemini 模型，根据文本提示词创建图像
• 图像修改：根据文本说明转换现有图像
• 背景移除：使用 remove.bg API 移除图像背景
• 图像托管：通过 FreeImage.host 分享生成的图像
• 资源管理：跟踪和管理生成及上传的图像

要求

• Python 3.11 或更高版本
• 所需的 API 密钥：
  • Google Gemini API 密钥 获取密钥
  • FreeImage.host API 密钥 获取密钥
  • Remove.bg API 密钥 获取密钥

安装

1. 克隆此仓库：

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

2. 安装 UV（如果尚未安装）：

   # 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. 使用 UV 安装依赖项：

   uv venv --python=python3.11
   source .venv/bin/activate #or .venv/Scripts/activate on Windows
   uv pip install -r requirements.txt
   

使用方法

1. Claude Desktop 集成：将以下配置添加到 claude_desktop_config.json 文件中，即可直接从 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"
     }
   }
   

   注意：将占位值 "key" 替换为你的实际 API 密钥。
2. Cursor 集成：
   Linux/macOS： 修改 cursor.sh 文件，设置 API 密钥和项目目录。

• 在 Cursor 设置中，转到“MCP”选项卡，然后点击 Add new MCP server，
• 为服务命名，并将命令设置为 sh /absolute/path/to/cursor.sh。
• 等待服务启动，即可查看服务和可用工具。
• 使用 Agent 时，它会自动判断是否使用这些工具。

Windows： 修改 cursor.bat 文件，设置 API 密钥和项目目录。

• 在 Cursor 设置中，转到“MCP”选项卡，然后点击 Add new MCP server，
• 为服务命名，并将命令设置为 cmd /c C:\absolute\path\to\cursor.bat。
• 等待服务启动，即可查看服务和可用工具。
• 使用 Agent 时，它会自动判断是否使用这些工具。

致谢

• Google Gemini：提供图像生成能力
• Remove.bg：提供背景移除服务
• FreeImage.host：提供图像托管服务
• MCP：提供 Model Context Protocol