JinDaGe - Image Toolkit MCP Details

article

README

🚀 PromptShopMCP

PromptShopMCP 是一个功能强大的 MCP（模型上下文协议）服务器，它允许你使用简单的文本命令将图像转换为图像。你可以像专业设计师一样编辑照片，只需用自然语言描述你想要的内容！

🚀 快速开始

PromptShopMCP 能让你轻松借助文本指令实现图像的生成与修改。你可以像专业设计师一样，用自然语言描述需求，即可完成照片编辑。

✨ 主要特性

图像生成：使用 Google 的 Gemini 模型从文本提示中创建图像。
图像修改：根据文本指令转换现有图像。
背景移除：使用 remove.bg API 去除图像背景。
图像托管：通过 FreeImage.host 共享生成的图像。
资源管理：跟踪和管理生成和上传的图像。

📦 安装指南

环境要求

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

安装步骤

克隆此仓库：

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

安装 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

使用 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：为模型上下文协议。

Image Toolkit