Image Analyzer MCP Server

基于本地 Ollama 服务的图片分析 MCP 工具，可直接在 Claude Desktop 等支持 MCP 的应用中使用，无需 API 密钥。

🎯 主要功能

🖼️ 图片分析 - 智能分析图片内容，支持多种格式
📄 文字提取 - 从图片中提取文字内容（OCR）
🎨 UI 分析 - 专门针对界面设计的分析功能
📦 批量处理 - 一次分析多张图片
🔒 隐私保护 - 完全本地运行，数据不上传

🚀 一分钟配置

第一步：安装 Ollama

# Windows: 从官网下载安装包
# https://ollama.ai/download

# macOS
brew install ollama

# Linux
curl -fsSL https://ollama.ai/install.sh | sh

第二步：下载模型

# 启动 Ollama 服务
ollama serve

# 下载图片分析模型（约 7GB）
ollama pull gemma3:12b

第三步：配置 MCP 客户端

以 Claude Desktop 为例，编辑配置文件：

Windows: %APPDATA%\Claude\claude_desktop_config.json macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "image-analyzer": {
      "command": "python",
      "args": ["你的项目路径/image_analyzer_server.py"],
      "env": {
        "OLLAMA_BASE_URL": "http://localhost:11434",
        "OLLAMA_MODEL": "gemma3:12b"
      }
    }
  }
}

重要: 将 你的项目路径 替换为实际的项目文件夹路径，例如：

Windows: F:/loen_space/img_mcp/image_analyzer_server.py
macOS: /Users/username/img_mcp/image_analyzer_server.py

第四步：重启 Claude Desktop

重启 Claude Desktop，即可开始使用图片分析功能！

📋 使用方法

配置完成后，在 Claude 中可以直接使用：

基础图片分析

请分析这张图片：[上传图片]

UI 界面分析

请分析这个界面的设计布局和组件

提取图片文字

请提取这张图片中的所有文字

批量分析

请分析这几张图片：[上传多张图片]

🔧 可用工具

工具名称	功能描述	使用场景
`analyze_image`	基础图片分析	日常图片内容分析
`analyze_image_categories`	分类分析	UI/UX 设计分析
`extract_text_from_image`	文字提取	OCR 识别
`batch_analyze_images`	批量分析	处理多张图片
`check_ollama_status`	状态检查	检查服务状态
`list_supported_formats`	格式列表	查看支持格式

⚙️ 高级配置（可选）

如需自定义配置，可创建 .env 文件：

# Ollama 服务地址（默认本地）
OLLAMA_BASE_URL=http://localhost:11434

# 使用模型（默认 gemma3:12b）
OLLAMA_MODEL=gemma3:12b

# 请求超时时间（秒）
OLLAMA_REQUEST_TIMEOUT=180

# 日志级别
LOG_LEVEL=INFO

🚨 常见问题

Q: Claude 中找不到图片分析工具？

A: 检查以下几点：

Ollama 服务是否正在运行
配置文件路径是否正确
是否已重启 Claude Desktop
查看 logs/ 目录中的日志文件

Q: 分析失败或报错？

确保 gemma3:12b 模型已下载完成
检查图片格式是否支持
确认 Ollama 服务端口 11434 未被占用

Q: 如何更换其他模型？

下载新模型：ollama pull 模型名
修改配置文件中的 OLLAMA_MODEL
重启 Claude Desktop

Q: 支持哪些图片格式？

A: 支持 JPEG、PNG、BMP、TIFF、GIF、WebP 等主流格式

📁 项目文件说明

img_mcp/
├── image_analyzer_server.py  # 主服务器文件（MCP 核心文件）
├── ollama_client.py          # Ollama 通信模块
├── requirements.txt          # Python 依赖包
├── .env.example             # 配置文件模板
└── README.md                # 使用说明

🔒 隐私说明

✅ 完全本地运行，图片数据不会离开您的设备
✅ 无需注册账号或 API 密钥
✅ 支持离线使用
✅ 无数据收集或上传

📞 获取帮助

如果遇到问题：

查看 logs/ 目录中的日志文件
检查 Ollama 服务状态：ollama list
确认模型是否正确下载：ollama show gemma3:12b

🎉 配置完成后，您就可以在 Claude 中直接使用强大的图片分析功能了！