mcp-imgutils

# MCP图片工具服务 这是一个基于Model Context Protocol (MCP)的全方位图片工具服务，提供图片分析和AI图片生成功能。 ## 功能特性 ### 📊 图片分析功能 - **🖼️ 图片查看与分析**: 将本地图片和网络图片转换为LLM可分析的格式 - **🌐 URL图片支持**: 直接支持HTTP/HTTPS图片URL，无需下载到本地 - **📊 完整图片信息**: 获取分辨率、大小、格式、颜色模式等技术参数 - **📷 EXIF元数据提取**: 提取拍摄参数、设备信息、GPS数据等完整EXIF信息 - **🔄 智能格式处理**: 自动处理各种图片格式和大小调整 - **🔒 安全验证**: URL格式验证、Content-Type检查、超时控制 - **🧹 自动清理**: 临时文件自动管理，无磁盘泄漏 - **📝 专业术语支持**: 保持英文EXIF键名，便于LLM理解专业摄影术语 ### 🎨 AI图片生成功能 - **🚀 多模型支持**: 支持 BFL FLUX 和 OpenAI DALL-E 系列模型 - **BFL FLUX**: flux-pro-1.1, flux-pro-1.1-ultra, flux-pro, flux-dev - **OpenAI DALL-E**: dall-e-3, dall-e-2 - **📐 智能尺寸**: 预设尺寸和自定义尺寸，自动调整到最佳参数 - **⚡ 高质量生成**: 业界领先的文本生成图片质量 - **📁 本地保存**: 图片自动下载到本地目录，避免大文件传输问题 - **🛡️ 完整错误处理**: API限制、网络错误、参数验证等全面处理 - **🔄 智能工作流**: 生成后可直接使用view_image工具查看分析 - **🎯 灵活配置**: 支持临时路径覆盖，满足不同使用场景 ## 安装 确保已安装必要的依赖： ```bash uv install # 或者 pip install -e . ``` ## 使用方法 ### Claude Desktop配置 这是一个MCP服务器，需要通过Claude Desktop配置使用。 **配置文件位置**: - **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json` - **Windows**: `%APPDATA%\Claude\claude_desktop_config.json` **配置内容**: 在Claude Desktop的配置文件中添加以下配置： ```json { "mcpServers": { "mcp-imgutils": { "command": "uvx", "args": ["mcp-imgutils"], "env": { "BFL_API_KEY": "your-bfl-api-key-here", "OPENAI_API_KEY": "your-openai-api-key-here" } } } } ``` ### 🔑 API密钥配置 #### BFL (Black Forest Labs) API密钥 要使用 BFL FLUX 模型生成图片，需要配置 BFL API密钥： 1. **获取API密钥**: 访问 [BFL API Portal](https://api.bfl.ai/) 注册并获取API密钥 2. **配置方式**: - **方式1 (推荐)**: 在Claude Desktop配置中添加环境变量（如上所示） - **方式2**: 设置系统环境变量 `export BFL_API_KEY=your-api-key` #### OpenAI API密钥 要使用 OpenAI DALL-E 模型生成图片，需要配置 OpenAI API密钥： 1. **获取API密钥**: 访问 [OpenAI API Portal](https://platform.openai.com/api-keys) 注册并获取API密钥 2. **配置方式**: - **方式1 (推荐)**: 在Claude Desktop配置中添加环境变量（如上所示） - **方式2**: 设置系统环境变量 `export OPENAI_API_KEY=your-api-key` #### 图片保存目录配置（可选） 默认情况下，生成的图片保存到： **BFL FLUX 模型**: -…