ModelScope Image

Provides image generation via ModelScope Qwen/Qwen-Image with MCP clients using full generation parameters.

javascript

1

GitHub Stars

javascript

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "yuandeshoulian-mcp-local-modelscope-image": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-modelscope-image"
      ],
      "env": {
        "MODELSCOPE_API_KEY": "your-api-key-here"
      }
    }
  }
}

This MCP server enables you to generate images with the ModelScope Qwen/Qwen-Image models through MCP clients. It supports in-client image generation with full control over prompts, resolution, seeds, steps, and guidance, and can be installed quickly using a one-line npx command or run locally for development.

How to use

You connect to the ModelScope Image MCP server from your MCP client (such as Claude Desktop) and start a generation request by providing both positive and negative prompts along with optional parameters like size, seed, steps, and guidance. The server handles the generation synchronously, waiting for the image to be created before returning the final result. Use natural language for basic generation or specify detailed parameters to control the output.

How to install

Prerequisites: you need Node.js 18 or later installed on your system.

Option 1: Install and run with npx (recommended) create a Claude Desktop MCP configuration with the following server entry.

{
  "mcpServers": {
    "modelscope-image": {
      "command": "npx",
      "args": ["-y", "mcp-modelscope-image"],
      "env": {
        "MODELSCOPE_API_KEY": "your-api-key-here"
      }
    }
  }
}

Additional installation options

Option 2: Global installation and a Claude Desktop compatible config.

npm install -g mcp-modelscope-image

{
  "mcpServers": {
    "modelscope-image": {
      "command": "mcp-modelscope-image",
      "env": {
        "MODELSCOPE_API_KEY": "your-api-key-here"
      }
    }
  }
}

Option 3: Local development

If you are developing locally, clone or download the project, install dependencies, and build.

# Clone or download the project
cd mcp-local-modelscope-image

# Install dependencies
npm install

# Build the project
npm run build

Claude Desktop configuration example (local development path)

If you run a local build, you can point Claude Desktop to the built index file.

{
  "mcpServers": {
    "modelscope-image": {
      "command": "node",
      "args": ["E:\\workspace\\jasion\\jq-mcp\\mcp-local-modelscope-image\\dist\\index.js"],
      "env": {
        "MODELSCOPE_API_KEY": "your-api-key-here"
      }
    }
  }
}

Available tools

generate_image

Generates an image using the Qwen/Qwen-Image model with full parameter support (prompt, negative_prompt, size, seed, steps, guidance, image_url).