Enhanced Image Analysis MCP Server

增强型图像分析MCP服务器

一个强大的模型上下文协议（MCP）服务器，它使用高级启发式方法来分析图像并生成智能的描述性文件名。非常适合组织大型照片集、截图和数字资产。

🚀 特性

• 🎯 智能图像分析：图像特征的高级启发式分析
• 📝 智能命名：四种命名风格（描述性、技术性、艺术性、位置性）
• 📂 批处理：使用递归搜索分析整个目录
• 🎨 颜色分析：主色检测和分类
• 📊 EXIF数据：提取相机设置、时间戳和元数据
• 📁 汽车组织：按内容、日期、大小或格式将图像排序到文件夹中
• 🔍 综合元数据：提取详细的技术信息
• ⚡ 智能缓存：避免重新分析未更改的图像

📦 安装

快速设置

cd /Users/anthonyturner/MCPs/image-analysis-server
chmod +x setup.sh
./setup.sh

手动安装

# Install dependencies
pip3 install mcp Pillow

# Make executable
chmod +x enhanced_image_analysis_server.py

⚙️ 配置

克劳德桌面

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "image-analysis": {
      "command": "python3",
      "args": ["/Users/anthonyturner/MCPs/image-analysis-server/enhanced_image_analysis_server.py"],
      "env": {}
    }
  }
}

配置文件位置：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• 视窗: %APPDATA%\\Claude\\claude_desktop_config.json

🛠️ 可用工具

1. ai_analyze_directory_images

分析目录中的所有图像并生成智能名称。

参数：

• directory_path （必填）：包含图像的目录路径
• recursive （可选）：搜索子目录（默认值：false）
• rename_files （可选）：实际重命名文件（默认值：false）
• prefix （可选）：为生成的名称添加前缀
• naming_style （可选）：命名风格（默认：“描述性”）

示例用法：

Analyze all images in ~/Pictures/vacation2024 and suggest better names using technical style

2. ai_analyze_single_image

分析单个图像文件并生成描述性名称。

参数：

• image_path （必填）：图像文件的路径
• naming_style （可选）：命名样式（默认：“描述性”）
• detailed_analysis （可选）：提供全面分析（默认：false）

示例用法：

Analyze /Users/me/Desktop/photo.jpg with detailed analysis using artistic naming style

3. extract_comprehensive_metadata

提取详细的元数据，包括EXIF数据和颜色分析。

参数：

• image_path （必填）：图像文件的路径
• include_color_analysis （可选）：包括调色板分析（默认值：true）

示例用法：

Extract comprehensive metadata from my screenshot including color analysis

4. organize_images_by_content

根据检测到的内容和特征将图像组织到文件夹中。

参数：

• directory_path （必填）：包含图像的目录路径
• create_folders （可选）：实际创建文件夹和移动文件（默认值：false）
• organization_method （可选）：组织方法（默认：“内容”）

组织方式：

• content：根据检测到的内容（屏幕截图、照片、肖像等）
• date：按创建日期（YYYY-MM格式）
• size：按图像分辨率（小、中、大、大）
• format：按文件格式（jpg、png、gif等）

🎨 命名样式

描述性（默认）

关注视觉内容和特征：

• red_landscape_photo.jpg
• blue_portrait_screenshot.png

技术性的

强调技术规格：

• large_res_landscape_camera.jpg
• medium_res_portrait_screenshot.png

艺术的

突出美学品质：

• red_bright_photo.jpg
• gray_dark_bw.png

位置

专为按上下文组织而设计：

• dated_landscape.jpg
• photo_portrait.png

📊 智能分析功能

颜色分析

• 主色：前5种颜色（百分比）
• 色彩系列：分类（红、蓝、绿等）
• 灰度检测：识别黑白图像
• 亮度分析：平均亮度计算

内容检测

服务器分析文件名模式以检测：

• 截图：屏幕截图和UI元素
• 照片：相机拍摄的图像和摄影
• 编辑图像：修改或处理的图像
• 扫描：数字化文件
• 徽标/图标：品牌和图形元素

EXIF数据提取

• 摄像头信息：品牌、型号、设置
• 时间戳：照片拍摄时
• 软件：编辑使用的应用程序
• GPS数据：位置信息（可用时）

🚀 示例工作流

组织下载文件夹

I have a messy Downloads folder with hundreds of images. Can you organize them by content type and suggest better names?

重命名度假照片

Analyze images in ~/Pictures/Hawaii2024 recursively, use descriptive naming with prefix "hawaii", and actually rename the files

技术分析

Extract comprehensive metadata from ~/Desktop/camera_test.jpg including color analysis and EXIF data

批量截图组织

Organize all images in ~/Desktop by content, actually create the folders and move files

🔧 高级功能

智能冲突解决

• 自动处理重复的文件名
• 需要时添加增量计数器
• 在预览模式下保留原始文件

性能优化

• 智能缓存：避免重新分析未更改的图像
• 高效的颜色分析：使用图像缩略图进行颜色检测
• 批处理：针对大型目录进行了优化

错误处理

• 故障弱化：如果一个文件失败，则继续处理其他文件
• 详细错误报告：清除错误消息以进行故障排除
• 文件验证：确保只处理支持的格式

📋 支持格式

• JPEG图像 （.jpg、.jpeg）
• 便携式网络图形 （.png）
• 图形交换格式 （.gif）
• 位图 （.bmp）
• 标签式图像文件格式 （.tiff）
• WebP （.webp）

🛡️ 安全功能

• 预览模式：默认行为建议更改而不应用它们
• 备份注意事项：在批处理操作之前，始终备份重要文件
• 权限检查：在操作之前验证文件系统权限
• 无损分析：元数据提取从不修改原始文件

🚨 故障排除

常见问题

1. “未找到图像文件”

- 验证目录路径是否正确 - 检查图像是否为支持的格式 - 尝试在子目录中递归搜索图像

1. “权限被拒绝”

- 确保目标目录的读/写权限 - 检查文件是否未被其他应用程序锁定

1. “无法分析图像”

- 文件可能已损坏或不是有效的图像 - 检查是否有足够的可用磁盘空间

调试模式

# Run with debug logging
python3 enhanced_image_analysis_server.py --debug

🔮 未来的增强功能

服务器设计为易于扩展：

• AI视觉集成：添加OpenAI GPT-4愿景或谷歌云愿景
• 人脸检测：识别和组织与人的照片
• 目标识别：检测特定物体、动物或场景
• 副本检测：查找和组织重复图像
• 云存储：支持谷歌照片、iCloud等。

📄 许可证

MIT许可证-随意修改和分发。

🤝 贡献

欢迎投稿！需要改进的地方：

• 其他命名样式
• 更复杂的内容检测
• 与云视觉API集成
• 性能优化
• 附加元数据提取

______________________________________________________________________

准备好智能地组织图像了吗？安装增强型图像分析MCP服务器，转换您的照片管理工作流程！