Image Processing MCP Server

Instructions

Implementation Reference

• tools/effects.py:893-1007 (handler)

  Core handler function implementing the polaroid effect: adds borders, optional rotation, and shadow to the input image.
  async def create_polaroid(arguments: Dict[str, Any]) -> List[TextContent]: """ 创建宝丽来照片效果 Args: arguments: 包含图片源和宝丽来参数的字典 Returns: List[TextContent]: 处理结果 """ try: # 参数验证 image_source = arguments.get("image_source") ensure_valid_image_source(image_source) border_width = arguments.get("border_width", 40) bottom_border = arguments.get("bottom_border", 80) border_color = arguments.get("border_color", "#FFFFFF") rotation = arguments.get("rotation", 0) output_format = arguments.get("output_format", DEFAULT_IMAGE_FORMAT) # 验证参数 validate_numeric_range(border_width, 10, 100, "border_width") validate_numeric_range(bottom_border, 20, 200, "bottom_border") validate_color_hex(border_color) validate_numeric_range(rotation, -15, 15, "rotation") # 加载图片 processor = ImageProcessor() image = processor.load_image(image_source) # 创建宝丽来边框 polaroid_width = image.width + 2 * border_width polaroid_height = image.height + border_width + bottom_border # 创建白色背景 border_rgb = tuple(int(border_color[i:i+2], 16) for i in (1, 3, 5)) polaroid = Image.new("RGB", (polaroid_width, polaroid_height), border_rgb) # 粘贴原图片 polaroid.paste(image, (border_width, border_width)) # 应用旋转 if rotation != 0: # 扩展画布以容纳旋转后的图片 diagonal = int(((polaroid_width ** 2 + polaroid_height ** 2) ** 0.5)) expanded = Image.new("RGBA", (diagonal, diagonal), (0, 0, 0, 0)) # 将宝丽来图片粘贴到扩展画布的中心 offset_x = (diagonal - polaroid_width) // 2 offset_y = (diagonal - polaroid_height) // 2 expanded.paste(polaroid, (offset_x, offset_y)) # 旋转 rotated = expanded.rotate(rotation, expand=True, fillcolor=(0, 0, 0, 0)) # 裁剪到合适大小 bbox = rotated.getbbox() if bbox: polaroid = rotated.crop(bbox) # 添加轻微的阴影效果 shadow_offset = 5 shadow_size = (polaroid.width + shadow_offset * 2, polaroid.height + shadow_offset * 2) final_image = Image.new("RGBA", shadow_size, (0, 0, 0, 0)) # 创建阴影 shadow = Image.new("RGBA", polaroid.size, (128, 128, 128, 100)) shadow = shadow.filter(ImageFilter.GaussianBlur(radius=3)) final_image.paste(shadow, (shadow_offset, shadow_offset), shadow) # 粘贴宝丽来图片 if polaroid.mode != "RGBA": polaroid = polaroid.convert("RGBA") final_image.paste(polaroid, (0, 0), polaroid) # 转换为base64 output_info = processor.output_image(final_image, "border", output_format) return [TextContent( type="text", text=json.dumps({ "success": True, "message": "成功创建宝丽来效果", "data": { **output_info, "metadata": { "original_size": f"{image.width}x{image.height}", "polaroid_size": f"{final_image.width}x{final_image.height}", "border_width": border_width, "bottom_border": bottom_border, "border_color": border_color, "rotation": rotation, "format": output_format } } }, ensure_ascii=False) )] except ValidationError as e: return [TextContent( type="text", text=json.dumps({ "success": False, "error": f"参数验证失败: {str(e)}" }, ensure_ascii=False) )] except Exception as e: return [TextContent( type="text", text=json.dumps({ "success": False, "error": f"创建宝丽来效果失败: {str(e)}" }, ensure_ascii=False) )]
• tools/effects.py:254-299 (schema)

  Input schema and Tool definition for create_polaroid in the effects tools list.
  Tool( name="create_polaroid", description="创建宝丽来照片效果", inputSchema={ "type": "object", "properties": { "image_source": { "type": "string", "description": "图片源（文件路径或base64编码）" }, "border_width": { "type": "integer", "description": "边框宽度（像素）", "minimum": 10, "maximum": 100, "default": 40 }, "bottom_border": { "type": "integer", "description": "底部边框宽度（像素）", "minimum": 20, "maximum": 200, "default": 80 }, "border_color": { "type": "string", "description": "边框颜色（十六进制格式）", "default": "#FFFFFF" }, "rotation": { "type": "number", "description": "旋转角度（度）", "minimum": -15, "maximum": 15, "default": 0 }, "output_format": { "type": "string", "description": "输出格式", "enum": ["PNG", "JPEG", "WEBP"], "default": "PNG" } }, "required": ["image_source"] } )
• main.py:624-646 (registration)

  MCP tool registration: wrapper function that prepares arguments and delegates to the effects handler.
  @mcp.tool() def create_polaroid( image_source: Annotated[str, Field(description="图片源，可以是文件路径或base64编码的图片数据")], border_width: Annotated[int, Field(description="宝丽来边框宽度（像素）", ge=1, default=20)], shadow: Annotated[bool, Field(description="是否添加阴影效果", default=True)], output_format: Annotated[str, Field(description="输出格式：PNG、JPEG、WEBP 等", default="PNG")] ) -> str: """创建宝丽来风格效果""" try: arguments = { "image_source": image_source, "border_width": border_width, "shadow": shadow, "output_format": output_format } result = safe_run_async(effects_create_polaroid(arguments)) return result[0].text except Exception as e: return json.dumps({ "success": False, "error": f"创建宝丽来效果失败: {str(e)}" }, ensure_ascii=False, indent=2)