mcp-id-photo

# 生成证件照 MCP 服务器 基于阿里云百炼 DashScope 的通义千问-图像编辑，提供一个工具即可一键生成并裁剪标准证件照，支持白/蓝/红背景与常用尺寸（一寸、二寸）。 ## ✨ 核心特性 - 🎯 单一工具：`make_id_photo` 完成生成 → 裁剪 → 保存全流程 - 🖼️ 背景替换：支持 `white` / `blue` / `red` 三种背景 - 📐 规格支持：一寸（295×413）、二寸-标准（413×531）、二寸-大（413×579） - 💾 自动保存：默认保存到桌面；可指定目录或文件路径 - ⚡ 同步返回：直接返回云端图片地址与本地保存路径，无需任务查询 ## 🔑 配置百炼 API Key DashScope 使用地域：中国大陆（北京）。请在运行环境设置环境变量： ```bash export DASHSCOPE_API_KEY="你的百炼 API Key（北京地域）" ``` Windows PowerShell： ```powershell $env:DASHSCOPE_API_KEY = "你的百炼 API Key（北京地域）" ``` ## 🚀 启动服务 直接运行模块： ```bash python -m mcp_id_photo.server ``` ## 🔧 在 MCP 客户端中配置 以 Claude Desktop / Cline / Kiro 为例： ```json { "mcpServers": { "id-photo": { "command": "python", "args": ["-m", "mcp_id_photo.server"], "env": { "DASHSCOPE_API_KEY": "sk-xxx" }, "disabled": false, "autoApprove": [] } } } ``` ## 📖 使用指南 ### 工具：`make_id_photo` 生成并保存标准证件照（同步）。流程： 1) 使用 `image_url + bg` 调用通义千问-图像编辑生成证件照； 2) 将结果按目标尺寸裁剪：默认二寸-标准（413×531），若传入 `spec` 则按规格； 3) 将成片保存到桌面或 `output_path` 指定位置；返回保存路径与元数据。 #### 参数 | 参数 | 类型 | 必填 | 默认值 | 说明 | |------|------|------|--------|------| | `image_url` | string | ✅ | - | 输入图片地址，需公网可访问的 `http/https` 链接 | | `output_path` | string | ❌ | 桌面 | 输出目录或最终文件路径；为目录时自动命名文件 | | `bg` | enum | ❌ | `blue` | 背景色：`white`、`blue`、`red` | | `spec` | enum | ❌ | - | 证件照规格：`一寸`、`二寸-标准`、`二寸-大` | 裁剪默认比例（推荐）： - 头顶到画面上边距约 `12%`（`top_margin_ratio = 0.12`） - 垂直裁剪高度约为主体包围盒的 `92%`（`expand_ratio = 0.92`） #### 调用示例 - 使用默认蓝底与默认二寸标准尺寸并保存到桌面： ``` make_id_photo(image_url="https://example.com/portrait.jpg") ``` - 指定红底、指定输出目录并自定义尺寸： ``` make_id_photo( image_url="https://example.com/portrait.jpg", output_path="D:\\Output\\ID", bg="red", spec="一寸" ) ``` - 指定规格为一寸并直接保存到某个文件路径： ``` make_id_photo( image_url="https://example.com/a.png", output_path="D:\\Output\\my_id.png", spec="一寸" ) ``` #### 返回结果示例 ```json { "success": true, "file_path": "C:\\Users\\you\\Desktop\\id_photo_413x531_1730000000.png",…