image_scale_by_percent

Resize images stored in Qiniu Cloud by percentage to adjust dimensions proportionally. Specify a percentage value to scale width and height, then retrieve the URL for the resized image.

Instructions

Image scaling tool that resizes images based on a percentage and returns information about the scaled image. The information includes the object_url of the scaled image, which users can directly use for HTTP GET requests to retrieve the image content or open in a browser to view the file. The image must be stored in a Qiniu Cloud Bucket. Supported original image formats: psd, jpeg, png, gif, webp, tiff, bmp, avif, heic. Image width and height cannot exceed 30,000 pixels, and total pixels cannot exceed 150 million.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`object_url`	Yes	The URL of the image. This can be a URL obtained via the GetObjectURL tool or a URL generated by other Fop tools. Length Constraints: Minimum length of 1.
`percent`	Yes	Scaling percentage, range [1,999]. For example: 90 means the image width and height are reduced to 90% of the original; 200 means the width and height are enlarged to 200% of the original.

Implementation Reference

src/mcp_server/core/media_processing/tools.py:48-73 (handler)

The main execution logic for the image_scale_by_percent tool. Validates inputs, constructs Qiniu FOP URL for scaling by percentage, and returns the processed image URL.

def image_scale_by_percent(
        self, **kwargs
) -> list[types.TextContent | types.ImageContent | types.EmbeddedResource]:
    object_url = kwargs.get("object_url", "")
    percent = kwargs.get("percent", "")
    if object_url is None or len(object_url) == 0:
        return [types.TextContent(type="text", text="object_url is required")]

    percent_int = int(percent)
    if percent_int < 1 or percent_int > 999:
        return [
            types.TextContent(type="text", text="percent must be between 1 and 999")
        ]

    func = f"imageMogr2/thumbnail/!{percent}p"
    object_url = utils.url_add_processing_func(auth=self.auth, url=object_url, func=func)
    return [
        types.TextContent(
            type="text",
            text=str(
                {
                    "object_url": object_url,
                }
            ),
        )
    ]

src/mcp_server/core/media_processing/tools.py:23-46 (schema)

Tool metadata including name, description, and input schema defining object_url (required string) and percent (required integer 1-999).

types.Tool(
    name="image_scale_by_percent",
    description="""Image scaling tool that resizes images based on a percentage and returns information about the scaled image.
    The information includes the object_url of the scaled image, which users can directly use for HTTP GET requests to retrieve the image content or open in a browser to view the file.
    The image must be stored in a Qiniu Cloud Bucket.
    Supported original image formats: psd, jpeg, png, gif, webp, tiff, bmp, avif, heic. Image width and height cannot exceed 30,000 pixels, and total pixels cannot exceed 150 million.
    """,
    inputSchema={
        "type": "object",
        "properties": {
            "object_url": {
                "type": "string", 
                "description": _OBJECT_URL_DESC
            },
            "percent": {
                "type": "integer",
                "description": "Scaling percentage, range [1,999]. For example: 90 means the image width and height are reduced to 90% of the original; 200 means the width and height are enlarged to 200% of the original.",
                "minimum": 1,
                "maximum": 999
            },
        },
        "required": ["object_url", "percent"],
    },
)

src/mcp_server/core/media_processing/tools.py:261-267 (registration)

The tool handler is registered via tools.auto_register_tools in the register_tools function.

    [
        tool_impl.image_scale_by_percent,
        tool_impl.image_scale_by_size,
        tool_impl.image_round_corner,
        tool_impl.image_info,
    ]
)

Qiniu MCP Server