Skip to main content
Glama
Sign In
ChongPlus Image MCP

ChongPlus Image MCP

by Rodert
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

ChongPlus Image MCP

An MCP server that lets AI assistants generate and edit images through the ChongPlus Image API.

Languages: English | 简体中文 | 繁體中文 | 日本語 | Español | Русский | 한국어

It is designed for normal chat usage: after installation, the assistant checks whether a key is configured, asks for one only when necessary, and saves it in the user's local configuration directory. Users do not need to set environment variables or run Python commands.

What the assistant can do

  • Check whether ChongPlus is ready to use.

  • Save or replace a ChongPlus API key securely.

  • Generate one to four images from a prompt.

  • Edit one local reference image with a prompt.

  • Explain available image sizes and limits.

Generated images are saved locally. The tools return their absolute paths, so an MCP client can show or open them.

Related MCP server: GPT-Image MCP Server

Install

Paste the following into an MCP-capable AI client:

Please install and configure ChongPlus Image MCP:
https://github.com/Rodert/chongplus-image-mcp

Install it as a local stdio MCP server using:
uvx --from git+https://github.com/Rodert/chongplus-image-mcp chongplus-image-mcp

After configuration, call setup_status to check the API key. If it is not configured, ask me for my ChongPlus API key and call configure_api_key to save it securely in the local configuration. Reuse the saved key afterwards and do not ask me to configure environment variables.

For manual configuration, use uvx:

{
  "mcpServers": {
    "chongplus-image": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/Rodert/chongplus-image-mcp", "chongplus-image-mcp"]
    }
  }
}

For a checked-out repository, replace the command and arguments with:

{
  "command": "uv",
  "args": ["run", "--directory", "/absolute/path/to/chongplus-image-mcp", "chongplus-image-mcp"]
}

First use

Ask the assistant to generate or edit an image. It should call setup_status first. If no key exists, it asks you for a ChongPlus API key and calls configure_api_key.

Get a key from https://api.chongplus.plus/keys; choose the image-generation group. Treat this as sensitive information: only provide it to an AI client and local MCP server you trust.

The key is stored at:

Platform

Location

macOS/Linux

$XDG_CONFIG_HOME/chongplus-image/config.json, or ~/.config/chongplus-image/config.json

Windows

%APPDATA%\\chongplus-image\\config.json

On macOS and Linux, the directory is set to 0700 and the file to 0600.

Tools

Tool

Purpose

setup_status

Returns whether a local API key has been saved.

configure_api_key

Securely saves a supplied API key. The server never returns it.

generate_image

Generates images from a prompt.

edit_image

Edits a local image using a prompt.

list_image_options

Lists supported sizes and request limits.

The server accepts existing local files for editing. It does not accept URLs, and it never returns file contents from arbitrary local paths.

Development

Requires Python 3.10 or newer and uv.

uv sync
uv run python -m unittest discover -s tests
uv run chongplus-image-mcp

Tests are offline and do not require an API key.

Errors

  • 401 or 403: the API key may be invalid, lack image-model access, or have no remaining quota.

  • 403 with Cloudflare 1010: ChongPlus's edge firewall blocked the request before the API processed it. Contact ChongPlus support with the approximate request time.

  • Connection errors: check your internet connection and retry.

The API source of truth is https://api.chongplus.plus/tools/image-studio/docs/.

Available Tools

5 tools
configure_api_keyB

Save a user's ChongPlus API key locally. api_key is sensitive: never repeat it in chat, logs, or tool results.

Inputs: api_key (required).

edit_imageB

Edit one existing local image with a prompt and save the result locally. image_path must be a local file path, not a URL.

Inputs: prompt (required), image_path (required), size, count, +1 more.

generate_imageB

Generate one to four images from a prompt and save them locally. Returns absolute image paths.

Inputs: prompt (required), size, count, output_directory.

list_image_optionsA

List ChongPlus image generation limits. Use this to choose a supported image size or count.

Inputs: no named parameters.

setup_statusA

Check whether this computer has a saved ChongPlus API key. Call this before image generation when setup is uncertain.

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A3.9/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: checking setup, configuring API key, listing options, generating images, and editing images. No overlap exists.

    Naming Consistency5/5

    Tool names follow a consistent verb_noun pattern (setup_status, configure_api_key, etc.) with underscores, making them predictable and easy to understand.

    Tool Count5/5

    With 5 tools, the server is well-scoped for image generation, covering setup, configuration, option discovery, generation, and editing without being too sparse or bloated.

    Completeness4/5

    The tool surface covers the core workflow (setup, config, generate, edit). A minor gap is the absence of a tool to list or manage previously generated images, but this does not severely impact the primary use case.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers