Image Edit Rmcp

🚀 图像编辑 MCP 服务

本项目提供一个对标 OpenAI Web 图像编辑功能的 MCP 服务，支持多种图像处理操作。同时，通过图像识别和描述功能，让纯文本模型也能“看见图片”，使传统语言模型能够理解和处理图像内容。

🚀 快速开始

体验地址

• MCP 连接地址：https://image.cd.actrue.cn/kB7XMqsX31s90JPV/mcp (httpstream)
• 图床地址：https://image.cd.actrue.cn/kB7XMqsX31s90JPV/upload
• 秘钥生成地址：https://image.cd.actrue.cn/secret

使用教程

CherryStudio 集成

⚠️ 重要提示

需要开启长时间运行模式。AI 生成图像功能耗时较长，建议在使用时保持耐心。

最佳实践

1. 将待处理的图片通过图床上传并且获得 url。
2. 将待处理的图片 url 通过 prompt 传递给模型。

图像内容识别

提示词：

https://muse-ai.oss-cn-hangzhou.aliyuncs.com/img/fd7409815bb94bddba84191e21a803a2.png
查看这张图片

图像内容裁剪

提示词：

https://muse-ai.oss-cn-hangzhou.aliyuncs.com/img/fd7409815bb94bddba84191e21a803a2.png
裁剪出图中的太阳
裁剪完成后展示出原图和裁剪结果

图像文字提取

提示词：

https://qianwen-res.oss-cn-beijing.aliyuncs.com/Qwen-Image/image2512/arena.png#center
识别图中文字
并且展示图片

✨ 主要特性

图像处理功能

• 图像内容识别：使用 Qwen3-VL 模型分析图像内容并生成描述。
• 图像裁剪：按百分比坐标裁剪图像。
• 图像旋转：支持 90°左旋、90°右旋和 180°翻转。
• 图像基础信息获取：获取图像尺寸、格式、大小等信息。
• 图像 OCR：从图像中提取文字内容。
• AI 图像生成：基于文本描述生成图像。
• AI 图像编辑：基于文本指令编辑现有图像。

简单图床

内置图像上传和存储功能，支持通过 URL 访问处理后的图像。

秘钥生成

提供 API 密钥生成和管理界面。

📦 安装指南

环境要求

• Rust 1.76 或更高版本
• Docker（可选，用于容器化部署）
• ModelScope API 密钥（用于 AI 功能）

Cargo 部署（推荐）

1. Rust 安装

# 使用 rustup 安装 Rust
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# 或从系统包管理器安装
# macOS: brew install rust
# Ubuntu/Debian: sudo apt install rustc cargo

2. 配置环境变量

复制环境变量模板并配置您的 API 密钥：

cp .env.example .env

编辑 .env 文件：

# ModelScope API 密钥（必填）
MODELSCOPE_API_KEY=your_api_key_here

# 服务器端口
MCP_PORT=3000

# 安全密钥（用于图床上传）
SECRET_KEY=your_secret_key_here

# 缓存目录
CACHE_DIR=~/.cache/image-edit-rmcp

# 缓存 URL（用于生成公开访问链接）
CACHE_URL=http://localhost:3000

3. 项目启动

# 克隆项目（如果尚未克隆）
# git clone <repository-url>
# cd image-edit-rmcp

# 安装依赖并构建
cargo build --release

# 运行服务
cargo run --release

服务将在 http://localhost:3000 启动。使用 http://localhost:3000/{SECRET_KEY}/mcp 访问 mcp 服务。

🔧 技术细节

工具介绍

1. fetch_image - 从 URL 获取图像

• 功能：从指定 URL 下载图像，分析图像内容，并生成描述。
• 输入参数：
  • url (string): 图像 URL（必需）
  • focus (string, 可选): 需要特别关注的内容
• 输出：
  • 图像 URL
  • 图像名称
  • MIME 类型
  • 图像描述文本

2. rotate_image - 旋转图像

• 功能：按指定方向旋转图像。
• 输入参数：
  • url (string): 图像 URL（必需）
  • direction (enum): 旋转方向，可选值：
    • Right90: 顺时针旋转 90°
    • Left90: 逆时针旋转 90°
    • Flip180: 旋转 180°
• 输出：
  • 旋转后的图像 URL（PNG 格式）

3. crop_image - 裁剪图像

• 功能：按百分比坐标裁剪图像。
• 输入参数：
  • url (string): 图像 URL（必需）
  • left (float, 可选): 左侧百分比（0 - 100），默认 0
  • top (float, 可选): 顶部百分比（0 - 100），默认 0
  • right (float, 可选): 右侧百分比（0 - 100），默认 100
  • bottom (float, 可选): 底部百分比（0 - 100），默认 100
• 输出：
  • 裁剪后的图像 URL（PNG 格式）

4. get_image_info - 获取图像信息

• 功能：获取图像的基本信息。
• 输入参数：
  • url (string): 图像 URL（必需）
• 输出：
  • width: 图像宽度（像素）
  • height: 图像高度（像素）
  • total_pixels: 总像素数
  • mime_type: MIME 类型
  • size: 文件大小（字节）
  • aspect_ratio: 宽高比（可选）

5. ocr_extract - OCR 文字提取

• 功能：从图像中提取文字内容。
• 输入参数：
  • image_url (string): 图像 URL（必需）
• 输出：
  • 提取的文本内容

6. generate_image - AI 生成图像

• 功能：基于文本描述生成图像。
• 输入参数：
  • prompt (string): 图像描述（必需）
  • negative_prompt (string, 可选): 不希望出现的内容
  • aspect_ratio (string, 可选): 宽高比，可选值：1:1、16:9、9:16、4:3、3:4、3:2、2:3，默认 1:1
  • resolution (string, 可选): 分辨率，可选值：1k、2k、4k，默认 1k
  • steps (u32, 可选): 采样步数
• 输出：
  • 生成的图像 URL

7. edit_image - AI 编辑图像

• 功能：基于文本指令编辑现有图像。
• 输入参数：
  • image_url (string): 待编辑图像 URL（必需）
  • prompt (string): 编辑指令（必需）
  • size (string, 可选): 输出图像尺寸
  • steps (u32, 可选): 采样步数
• 输出：
  • 编辑后的图像 URL

工具的实现方式

技术栈

• 后端框架：Rust + Axum + RMCP
• 图像处理：image 库（支持 PNG、JPEG、GIF、BMP、WebP）
• AI 集成：ModelScope API（Qwen3-VL、Z-Image-Turbo、Qwen-Image-Edit）
• 缓存系统：本地文件缓存，支持 HTTP 访问
• Web 界面：Axum 静态文件服务 + HTML 模板

核心实现原理

1. 图像处理流程：

• 接收 HTTP URL 输入。
• 下载图像到内存。
• 使用 image 库进行解码和处理（旋转、裁剪）。
• 编码为 PNG 格式输出。
• 缓存处理结果到本地文件系统。

2. AI 功能集成：

• 图像识别：调用 ModelScope Qwen3-VL 模型分析图像内容。
• OCR 提取：使用 Qwen3-VL 模型提取图像中的文字。
• 图像生成：使用 Z-Image-Turbo 模型基于文本生成图像。
• 图像编辑：使用 Qwen-Image-Edit 模型基于指令编辑图像。

3. 缓存机制：

• 基于 URL 和参数计算哈希值。
• 将处理结果存储到本地缓存目录。
• 通过 HTTP 服务提供缓存文件的公开访问。
• 支持元数据（图像信息、描述等）存储。

4. MCP 协议集成：

• 实现 RMCP 协议的 ServerHandler。
• 提供标准的工具调用接口。
• 支持 httpstream 传输协议。

依赖库

主要依赖（见 Cargo.toml）：

• rmcp: MCP 协议实现
• axum: Web 框架
• image: 图像处理
• reqwest: HTTP 客户端
• serde: JSON 序列化
• tokio: 异步运行时