关键词

GIMPAI图像编辑图像处理模型上下文协议自动化工作流

GIMP AI助手 (GIMP-MCP) 使用说明

项目简介

GIMP AI助手 (GIMP-MCP) 是一个桥梁工具，它通过模型上下文协议 (MCP) 将强大的 AI 功能引入到开源图像编辑软件 GIMP 中。通过这个工具，你可以利用 AI 模型进行图像处理，例如智能背景移除、图像修复、风格迁移等，从而提升你的 GIMP 工作流程。

主要功能点

  • AI 功能集成: 连接 AI 模型，为 GIMP 增加智能图像处理能力。
  • 自动化工作流: 利用 AI 自动执行重复性图像编辑任务。
  • 上下文感知操作: AI 模型理解图像内容，进行更智能的编辑操作。
  • GIMP API 控制: 通过 MCP 协议调用 GIMP 丰富的 API 功能，例如创建图像、图层管理、图像编辑等。

安装步骤

  1. 安装 GIMP: 确保已安装 GIMP 2.10 或更高版本。
  2. 安装 Python: 确保已安装 Python 3.x。
  3. 克隆仓库: 克隆 gimp-mcp 仓库到本地。 
    git clone https://github.com/libreearth/gimp-mcp.git
cd gimp-mcp
  4. 安装依赖: 如果仓库包含 'requirements.txt' 文件，请运行以下命令安装 Python 依赖库。 
    pip install -r requirements.txt
    注意：如果仓库中没有 'requirements.txt' 文件，可能需要手动安装 'mcp' 等必要的库，具体取决于 'gimp_mcp_client.py' 脚本的依赖。
  5. 复制插件: 将 'gimp_mcp_server.py' 文件复制到 GIMP 的插件目录。不同操作系统插件目录位置可能不同，请参考仓库 README 或 GIMP 官方文档查找插件目录。
    • 示例目录 (Linux): '~/.config/GIMP/2.10/plug-ins/'
    • 示例目录 (Windows): 'C:\Users<用户名>\AppData\Roaming\GIMP\2.10\plug-ins'
    • 示例目录 (macOS): '~/Library/Application Support/GIMP/2.10/plug-ins/'
  6. 启动 MCP 服务器: 运行 'gimp_mcp_client.py' 脚本以启动 MCP 服务器。 
    python gimp_mcp_client.py
  7. 启动 GIMP 插件: 启动 GIMP 软件，然后在 GIMP 菜单栏中，选择 "滤镜" -> "Development" -> "Start MCP Server" 启动 GIMP 插件服务器。

服务器配置 (MCP 客户端配置)

当您开发 MCP 客户端并希望连接到 GIMP-MCP 服务器时，您需要配置客户端以连接到 'gimp_mcp_client.py' 启动的 MCP 服务器。以下是一个典型的 JSON 格式配置示例，用于描述如何启动和连接到 GIMP-MCP 服务器：

{
  "serverName": "GIMP-MCP",
  "command": "python",
  "args": ["/path/to/gimp-mcp/gimp_mcp_client.py"]
  // "args": [] // 如果 gimp_mcp_client.py 已经在运行，并且客户端只需要连接，则参数可以为空
}

配置参数说明:

  • 'serverName': 自定义的服务器名称，用于在 MCP 客户端中标识此连接。
  • 'command': 用于启动 MCP 服务器的命令。这里假设您使用 Python 运行 'gimp_mcp_client.py' 脚本。
  • 'args': 传递给启动命令的参数列表。
    • '"/path/to/gimp-mcp/gimp_mcp_client.py"': 请务必替换为 'gimp_mcp_client.py' 脚本在您本地文件系统中的实际路径。 这是启动 MCP 服务器的核心脚本。
    • 如果 'gimp_mcp_client.py' 已经在独立终端中运行，并且您的 MCP 客户端只需要连接到它（例如，通过网络套接字，如果 'gimp_mcp_client.py' 监听网络连接），则 'args' 数组可以为空，或者包含其他连接参数（如果 'gimp_mcp_client.py' 支持）。

注意: 此配置假设 MCP 客户端和 GIMP-MCP 服务器 ('gimp_mcp_client.py') 运行在同一台机器上。 如果您需要通过网络连接到运行在不同机器上的 GIMP-MCP 服务器，则需要根据 'gimp_mcp_client.py' 的具体实现和网络配置进行调整（例如，修改 'gimp_mcp_client.py' 以监听特定 IP 地址和端口，并在 MCP 客户端中配置相应的连接信息）。

基本使用方法

  1. 启动所有组件: 按照上述安装步骤，先启动 'gimp_mcp_client.py' MCP 服务器，再启动 GIMP 插件服务器。
  2. 配置 MCP 客户端: 在您的 MCP 客户端应用中，根据 "服务器配置" 部分的说明，配置连接到 GIMP-MCP 服务器。
  3. 通过 MCP 客户端控制 GIMP: 使用 MCP 客户端发送指令，例如调用 GIMP API 执行图像编辑操作。 您可以参考 'gimp_mcp_client.py' 中定义的 'call_api' 工具以及 'README.md' 中 "Available API Commands" 部分，了解可用的 API 命令和功能。 例如，您可以调用 'list_images' 工具列出 GIMP 中打开的图像，或者使用 'apply_gaussian_blur' 工具对图像应用高斯模糊。

信息

分类

AI与计算

访问项目