image-mcp-server

# Image MCP Server 一个简洁的 MCP (Model Context Protocol) 服务器，专门用于图片内容分析。基于阿里云通义千问3-VL-Plus模型，支持本地图片文件和剪贴板图片的分析。 ## 功能特点 - 🖼️ **多格式支持**: 支持 JPEG、PNG、GIF、WebP、BMP、TIFF 等主流图片格式 - 📋 **剪贴板支持**: 可以直接分析剪贴板中的图片 - 🔧 **简单易用**: 通过 uvx 一键安装和配置 - 🤖 **智能分析**: 基于通义千问3-VL-Plus的强大视觉理解能力 - ⚡ **高性能**: 异步处理，支持快速响应 ## 安装 ### 使用 uvx 安装（推荐） ```bash # 通过 uvx 安装最新版本 uvx image-mcp-server@latest ``` ### 使用 pip 安装 ```bash pip install image-mcp-server ``` ## 配置 ### 1. 获取 API 密钥 访问 [阿里云百炼平台](https://bailian.console.aliyun.com/) 获取 DashScope API 密钥。 ### 2. 配置 Claude Desktop 在 Claude Desktop 的配置文件中添加以下配置： **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json` **Windows**: `%APPDATA%\Claude\claude_desktop_config.json` ```json { "mcpServers": { "image-mcp-server": { "command": "uvx", "args": ["image-mcp-server@latest"], "env": { "IMAGE_MCP_DASHSCOPE_API_KEY": "your-dashscope-api-key-here" } } } } ``` ### 3. 环境变量配置 你也可以通过环境变量配置 API 密钥： ```bash export IMAGE_MCP_DASHSCOPE_API_KEY="your-dashscope-api-key-here" ``` 或者创建 `.env` 文件： ```bash # 复制示例文件 cp .env.example .env # 编辑 .env 文件，填入你的 API 密钥 ``` ## 使用方法 ### 1. 分析本地图片文件 ``` 请分析这张图片: ./path/to/your/image.jpg ``` ### 2. 分析剪贴板图片 ``` 请分析剪贴板中的图片 ``` ### 3. 带问题分析 ``` 分析这张图片并回答: 这张图片中主要展示了什么内容？ ``` ## 支持的输入格式 - **文件路径**: `./image.jpg`, `/path/to/image.png`, `../images/photo.gif` - **剪贴板**: `clipboard` (关键词) - **相对路径**: 支持相对当前工作目录的路径 - **绝对路径**: 支持完整的文件系统路径 ## 支持的图片格式 - JPEG (.jpg, .jpeg) - PNG (.png) - GIF (.gif) - WebP (.webp) - BMP (.bmp) - TIFF (.tiff) ## 开发 ### 环境准备 ```bash # 克隆仓库 git clone https://github.com/yourusername/image-mcp-server.git cd image-mcp-server # 创建虚拟环境 python -m venv venv source venv/bin/activate # Windows: venv\Scripts\activate # 安装依赖 pip install -e ".[dev]" ``` ### 运行测试 ```bash pytest ``` ### 代码格式化 ```bash black src/ isort src/ ``` ### 类型检查 ```bash mypy src/ ``` ## 项目结构 ``` image_mcp_server/ ├── src/image_mcp_server/ │ ├──…