ModelScope Image Generation MCP

A powerful Model Context Protocol (MCP) server that integrates with ModelScope's image generation capabilities, enabling seamless AI image creation and model discovery through chat interfaces.

Features

🔍 Model Discovery: Search and explore models on ModelScope using keywords with advanced filtering options
🎨 Text-to-Image: Generate high-quality images from text descriptions using state-of-the-art models
🖼️ Image-to-Image: Transform existing images based on text prompts for creative editing
📊 Model Analytics: Sort models by popularity, download count, or modification date
🚀 Easy Integration: Seamless integration with MCP-compatible chat clients

Available Tools

Model Search Tool

🔍 search_models - Search and discover models on ModelScope

Parameter	Type	Description	Example
`query`	string	Search keywords	`"Flux"`, `"SDXL"`, `""`
`task`	string	Filter by task type (optional)	`"text-to-image"`
`libraries`	string	Filter by library type (optional)	`"LoRA"`
`sort`	string	Sort order (optional)	`"DownloadsCount"`, `"StarsCount"`, `"GmtModified"`
`limit`	integer	Number of results (1-30) (optional)	`10`

Image Generation Tools

🎨 generate_image_url_from_text - Create images from text descriptions

Parameter	Type	Description	Default
`description`	string	Text prompt for image generation	Required
`model`	string	Default Model ID to use	`"Qwen/Qwen-Image"`

✍️ generate_image_url_from_text_and_image_url - Transform existing images

Parameter	Type	Description	Default
`description`	string	Text prompt for image transformation	Required
`image_url`	string	URL of input image	Required
`model`	string	Default Model ID to use	`"black-forest-labs/FLUX.1-Kontext-dev"`

Popular Models Available

Text-to-Image: Qwen/Qwen-Image (Default)
Image-to-Image: black-forest-labs/FLUX.1-Kontext-dev (Default)
And 10000+ more models available through ModelScope platform!

Configuration

Step 1: Obtain API Key

Obtain your API key from ModelScope API Key for API access.

Step 2: Configure MCP Client

Add the following configuration to your MCP client (e.g., Cherry Studio, Claude Desktop):

{
  "modelscope-image-gen-mcp": {
    "command": "uvx",
    "args": ["ms_image_gen_mcp@latest"],
    "env": {
      "MODELSCOPE_API_KEY": "YOUR_MODELSCOPE_API_KEY"
    }
  }
}

Development

Prerequisites

Python 3.11+: Required for running the MCP server
ModelScope API Key: Obtain from ModelScope for API access
Node.js (optional): Required for MCP Inspector debugging

Installation

Install the package via pip:

pip install ms-image-gen-mcp

Debugging with MCP Inspector

For development and debugging, use the MCP Inspector:

npx @modelcontextprotocol/inspector -e MODELSCOPE_API_KEY=YOUR_MODELSCOPE_API_KEY python -m ms_image_gen_mcp

Version History

Version	Changes
1.3.0	Add parameters to image generation tools (size, steps, guidance scale, etc.)
1.2.0	Convert to async API
1.1.0	Add model search and image-to-image generation
1.0.0	Initial release with text-to-image generation

Metadata

Release files for ms-image-gen-mcp 1.3.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for ms-image-gen-mcp 1.3.0
File	Interpreter	ABI	Platform	Reset
ms_image_gen_mcp-1.3.0-py3-none-any.whl 5.7 kB Aug 26, 2025 Without provenance	Python 3	none	any	Details

Release files / ms_image_gen_mcp-1.3.0-py3-none-any.whl

Download URL	ms_image_gen_mcp-1.3.0-py3-none-any.whl
Size	5.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`d491952c52d0612c7c42f36c083ee5664e8f77e52fcd6058ce527f636917a03f`
BLAKE2b-256 checksum How to use checksums	`6ad5f29565ca28efb826cb9b8f9998b22f6627b23fbd143d1a3aa87d3c741143`
Upload date	Aug 26, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.12.9`

Security for ms-image-gen-mcp 1.3.0

Report project as malware

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.