adjust_saturation
Modify image saturation levels by specifying a factor to enhance or reduce color intensity, or convert images to grayscale using the Image Processing MCP Server tool.
Instructions
调整图片饱和度
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| factor | Yes | 饱和度调整因子，1.0为原始饱和度，>1.0增强，<1.0减弱，0为灰度 | |
| image_source | Yes | 图片源，可以是文件路径或base64编码的图片数据 |
Implementation Reference
- tools/color_adjust.py:345-398 (handler)Core handler function that loads the image, validates the saturation factor, applies saturation adjustment using PIL's ImageEnhance.Color.enhance(), processes output, and returns JSON result.async def adjust_saturation(image_source: str, factor: float) -> list[TextContent]: """ 调整图片饱和度 Args: image_source: 图片数据（base64编码）或文件路径 factor: 饱和度调整因子（0.0-2.0） Returns: 调整后的图片数据 """ try: # 验证参数 if not image_source: raise ValidationError("图片数据不能为空") if not validate_numeric_range(factor, 0.0, 2.0): raise ValidationError(f"饱和度因子必须在0.0-2.0范围内: {factor}") # 加载图片 image = processor.load_image(image_source) # 调整饱和度 enhancer = ImageEnhance.Color(image) enhanced_image = enhancer.enhance(factor) # 输出处理后的图片 output_info = processor.output_image(enhanced_image, "saturation") result = { "success": True, "message": f"饱和度调整成功: 因子 {factor}", "data": { **output_info, "saturation_factor": factor, "size": image.size } } return [TextContent(type="text", text=json.dumps(result, ensure_ascii=False))] except ValidationError as e: error_result = { "success": False, "error": f"参数验证失败: {str(e)}" } return [TextContent(type="text", text=json.dumps(error_result, ensure_ascii=False))] except Exception as e: error_result = { "success": False, "error": f"饱和度调整失败: {str(e)}" } return [TextContent(type="text", text=json.dumps(error_result, ensure_ascii=False))]
- main.py:414-428 (registration)Registers the 'adjust_saturation' tool with the FastMCP server using @mcp.tool() decorator. Provides input schema via Annotated[Field] parameters and sync wrapper calling the async handler.@mcp.tool() def adjust_saturation( image_source: Annotated[str, Field(description="图片源，可以是文件路径或base64编码的图片数据")], factor: Annotated[float, Field(description="饱和度调整因子，1.0为原始饱和度，>1.0增强，<1.0减弱，0为灰度", ge=0)] ) -> str: """调整图片饱和度""" try: result = safe_run_async(color_adjust_saturation(image_source, factor)) return result[0].text except Exception as e: return json.dumps({ "success": False, "error": f"调整饱和度失败: {str(e)}" }, ensure_ascii=False, indent=2)
- tools/color_adjust.py:65-84 (schema)JSON schema definition for the 'adjust_saturation' tool input in the get_color_adjust_tools() function.Tool( name="adjust_saturation", description="调整图片饱和度", inputSchema={ "type": "object", "properties": { "image_source": { "type": "string", "description": "图片数据（base64编码）或文件路径" }, "factor": { "type": "number", "description": "饱和度调整因子（0.0-2.0，1.0为原始饱和度，0.0为灰度）", "minimum": 0.0, "maximum": 2.0 } }, "required": ["image_source", "factor"] } ),