GIMP MCP (Reyisjones)

🎨 GIMP MCP-用于VS代码的AI图像生成器

使用稳定扩散AI从文本描述生成图像-通过模型上下文协议（MCP）与VS代码集成

  

______________________________________________________________________

📖 概述

GIMP MCP是一个基于人工智能的图像生成工具，通过模型上下文协议与VS Code集成。它使您能够使用稳定扩散从文本描述生成图像，并自动回退到基于PIL的草图。

✨ 主要特点

• 🤖 AI驱动：使用稳定扩散生成逼真的图像
• ✨ 智能增强：通过降噪、锐化和伪影去除自动增强图像
• 🎯 VS代码集成：通过MCP与GPT-4o Agent无缝协作
• ⚡ 快速：草图为亚二代，AI图像约为10秒
• 🎨 双模式：人工智能生成或基于PIL的快速草稿
• 📦 批处理：一次生成和增强多个图像
• 🎬 动画支持：创建具有自动帧增强功能的动画GIF
• 🖼️ GIMP集成：可选GIMP批处理操作，以提高专业级别
• 🛠️ 轻松设置：用于快速生成的简单bash脚本

______________________________________________________________________

🚀 快速开始

先决条件

• Python 3.9+
• 带有GPT-4o代理的VS代码
• 互联网连接（用于AI模式）

安装

# 1. Navigate to project directory
cd /path/to/GimpMCP

# 2. Create virtual environment
python3 -m venv .venv

# 3. Activate virtual environment
source .venv/bin/activate

# 4. Install dependencies
pip install -r requirements.txt

生成您的第一张图片

使用bash脚本：

./generate_image.sh "A serene mountain landscape at sunset" "mountain_sunset"

直接使用Python：

python3 MCP/gimp-image-gen/gimp_image_gen.py \
  --prompt "A serene mountain landscape at sunset" \
  --output_file "output/mountain_sunset.png" \
  --use-ai

______________________________________________________________________

📚 文档

• QUICKSTART.md -30秒后开始
• 动画指南.md -从文本序列创建动画GIF
• PROMPT_EXAMPLES.md -20+示例提示和最佳实践
• 集成_摘要.md -技术实施细节
• 更改日志.md -版本历史和更新

______________________________________________________________________

💻 用法

两种发电模式

1.AI模式（推荐）

使用稳定扩散获得逼真、详细的图像：

./generate_image.sh "A futuristic cyberpunk city at night" "cyberpunk"

2.草图模式

基于PIL的快速占位符，用于快速草稿：

python3 MCP/gimp-image-gen/gimp_image_gen.py \
  --prompt "Quick concept sketch" \
  --output_file "output/sketch.png"

VS代码集成

直接询问GPT-4o代理：

"Generate an image of a vintage sports car in red, sunset lighting"

代理将自动调用该工具并创建您的映像。

批量生成

一次生成多个图像：

python3 batch_generate.py output/storyboards

动画生成

从文本序列创建动画GIF：

./generate_animation.sh \
  "A sunrise over mountains" \
  "Morning light on peaks" \
  "Full daylight landscape" \
  "mountain_animation"

增强动画（新增！）

通过自动帧增强生成：

python3 generate_animation.py \
  --prompts "Frame 1" "Frame 2" "Frame 3" \
  --use-ai \
  --enhance \
  --enhancement-preset medium \
  --output-name enhanced_animation.gif

图像增强

增强现有图像：

# Basic enhancement
python3 enhance_image.py input.png -o output.png

# With GIMP for professional quality
python3 enhance_image.py input.png -o output.png --use-gimp --preset aggressive

# Batch enhance animation frames
python3 preprocess_frames.py animations/ -o animations_enhanced/

看 增强版_GUIDE.md 以获取完整的增强文档。

看 动画指南.md 查看详细的动画功能。

______________________________________________________________________

🎨 示例

检查 PROMPT_EXAMPLES.md 对于20多个分类示例：

• 🚗 车辆和运输
• 🏠 建筑与建筑物
• 👤 人物与人物
• 🌄 自然与景观
• 🎨 抽象与艺术
• 🍕 食品和饮料
• 🎮 游戏与技术

示例输出

______________________________________________________________________

🗂️ 项目结构

GimpMCP/
├── .venv/                      # Python virtual environment
├── .vscode/
│   └── settings.json           # VS Code MCP configuration
├── MCP/
│   └── gimp-image-gen/
│       ├── manifest.json       # MCP tool definition (v2.0)
│       └── gimp_image_gen.py   # Core image generator
├── output/                     # Generated images
├── animations/                 # Animation frames and GIFs
├── generate_image.sh           # Quick generation script
├── generate_animation.sh       # Animation generation script
├── generate_animation.py       # Animation generator (Python)
├── batch_generate.py           # Batch processing
├── enhance_image.py            # Image enhancement tool (NEW)
├── preprocess_frames.py        # Frame batch enhancement (NEW)
├── requirements.txt            # Python dependencies
├── ENHANCEMENT_GUIDE.md        # Enhancement documentation (NEW)
├── FEATURES.md                 # Feature roadmap (NEW)
└── README.md                   # This file

______________________________________________________________________

⚙️ 配置

AI提供商

目前使用 投票.ai （免费，不需要API密钥）。

要添加拥抱面部支持，请执行以下操作：

1. 从获取API令牌 拥抱脸
2. 编辑 gimp_image_gen.py:

headers["Authorization"] = "Bearer YOUR_TOKEN"

______________________________________________________________________

🔧 故障排除

常见问题

“未找到模块'PIL'”

source .venv/bin/activate
pip install Pillow

“权限被拒绝：./generate_image.sh”

chmod +x generate_image.sh

“人工智能生成失败”

• 检查互联网连接
• 工具自动回退到PIL模式
• 尝试简化提示

获取帮助

• 审查 QUICKSTART.md 关于设置问题
• 检查 PROMPT_EXAMPLES.md 获取快速提示
• 看 集成_摘要.md 了解技术细节

______________________________________________________________________

🎯 最佳结果提示

对于AI模式

• 具体描述
• 包括艺术风格（“照片级真实感”、“卡通风格”等）
• 提及照明（“黄金时段”、“工作室照明”）
• 添加质量术语（“高度详细”、“专业”）

示例良好提示

✅ "A luxury sports car in metallic blue, side view, detailed reflections, photorealistic, studio lighting"
✅ "A cozy coffee shop interior, warm lighting, wooden furniture, people chatting, illustration style"
✅ "A majestic medieval castle on hilltop, dramatic cloudy sky, fantasy art style, epic atmosphere"

不良提示示例

❌ "A car" (too vague)
❌ "Nice picture of something" (no specifics)
❌ "Image" (not descriptive)

______________________________________________________________________

📊 演出

______________________________________________________________________

🚀 未来的增强功能

• \[\]支持DALL·E和其他人工智能提供商
• \[\]自定义图像大小和纵横比
• \[\]从参考图像转换样式
• \[\]动画支持视频格式（MP4、WebM）
• \[\]高级GIMP脚本集成
• \[\]面向非技术用户的WebUI

______________________________________________________________________

📄 许可证

MIT许可证-请参阅 许可证 详情

______________________________________________________________________

🙏 致谢

• 稳定扩散 -AI图像生成模型
• 投票.ai -免费人工智能推理API
• PIL/枕头 -Python映像库
• 模型上下文协议 -VS代码集成框架

______________________________________________________________________

📞 支持

如有疑问或问题：

1. 检查上述文件
2. 审查 PROMPT_EXAMPLES.md
3. 看 集成_摘要.md

______________________________________________________________________

版本: 3.1.0\ 最后更新：2025年11月19日\ 状态: ✅ 生产就绪

由以下材料制成❤️ 用于创意工作流程