Image Toolkit

🚀 PromptShopMCP

PromptShopMCP 是一個功能強大的 MCP（模型上下文協議）服務器，它允許你使用簡單的文本命令將圖像轉換為圖像。你可以像專業設計師一樣編輯照片，只需用自然語言描述你想要的內容！

🚀 快速開始

PromptShopMCP 能讓你輕鬆藉助文本指令實現圖像的生成與修改。你可以像專業設計師一樣，用自然語言描述需求，即可完成照片編輯。

✨ 主要特性

• 圖像生成：使用 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（如果尚未安裝）：

# 在 macOS 和 Linux 上。
curl -LsSf https://astral.sh/uv/install.sh | sh
# 在 Windows 上。
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
# 使用 pip。
pip install uv

3. 使用 UV 安裝依賴項：

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

💻 使用示例

基礎用法

Claude 桌面集成

將以下配置添加到你的 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 密鑰。

Cursor 集成

Linux/macOS： 修改 cursor.sh 文件以設置你的 API 密鑰和項目目錄。

• 在 Cursor 設置中，轉到 "MCP" 選項卡，點擊 Add new MCP server。
• 將服務器命名為任意名稱，並將命令設置為 sh /absolute/path/to/cursor.sh。
• 等待服務器啟動後，你可以在可用工具中看到服務器和工具。
• 然後當你使用代理時，它會自動檢測是否使用工具。

示例展示

原始圖片

提示：add a coat to the dog

提示：Add a hat to it

📚 詳細文檔

致謝

• Google Gemini：提供圖像生成功能。
• Remove.bg：提供背景移除服務。
• FreeImage.host：提供圖像託管服務。
• MCP：為模型上下文協議。