kokon-mcp
Installed, started with no arguments, no environment and no input, and listed its tools. Run 2026-11-16.
Needs to start: nothing
Contacts while installing and starting: nothing
What it contacted
Nothing besides the npm registry it was installed from. Watched from outside its sandbox while it was installed and started with no input. Its tools may still contact things when called.
Starting it
npx -y kokon-mcp@0.12.1
Installing a package runs its code. Use a sandbox for anything you have not read.
What its tools tell an agent
In the tool descriptions, nothing that talks about the user, other tools or private files, or uses hidden characters.
Found by simple pattern rules in each tool's description (up to 3,000 characters), quoted as written. Parameter descriptions are not scanned. A clean result is not a safety review.
Tools
generate_image prompt, reference_images, width, height, aspect_ratio, quality, seed, output_path, include_preview
Generate an image from a text prompt with the local Qwen-Image 2.1 model, optionally using reference images (a person, a product, a style) in a new scene. Write the full, detailed prompt yourself (see the prompt field): it is used as is. Dimensions are chosen automatically (aspect ratio can be inferred from the prompt, e.g. '16:9 hero image') unless width/height or aspect_ratio are given. Returns the absolute path of the saved PNG. Runs fully offline; typically 45 s–4 min.
edit_image image_path, prompt, output_path, quality, preserve_dimensions, seed, include_preview
Edit an existing image with a natural-language instruction (e.g. 'make the background nighttime, keep the foreground unchanged'). Preserves the input's width, height and aspect ratio by default. The input file is never overwritten.
edit_images image_paths, prompt, width, height, aspect_ratio, quality, seed, output_path, include_preview
Edit image 1 with the help of other images (up to 10 in all) and an instruction, e.g. put the product from image 2 in the hand of the person in image 1. Order matters: refer to them as image 1, image 2, ... in the prompt. The output follows image 1's aspect ratio unless width/height or aspect_ratio are given. For a new scene that only uses the images as references, use generate_image with reference_images.
outpaint_image image_path, prompt, left, right, top, bottom, units, seed, quality, output_path, include_preview
Extend an image beyond its borders. Give the expansion per side in pixels or percent; the canvas, mask and model-aligned sizes are built automatically and the original pixels are preserved exactly.
inpaint_image image_path, mask_path, action, prompt, seed, quality, output_path, include_preview
Change only the masked area of an image (mask: white = change, black = keep): edit it, remove what is there, replace it, or add something inside it. The model is shown the area marked on a copy of the image; pixels outside the mask are preserved exactly.
upscale_image image_path, scale, width, height, output_path, include_preview
Enlarge an image (default 2x, or to a width/height up to 8192 px). Runs the upscaler model chosen in Kokon (Superscale-SP by default; seconds on a PC GPU, longer on a Mac; adds no new content). Saves a new file; the input is never overwritten.
get_image_info image_path
Width, height, aspect ratio, file type and, for images made by Kokon, the generation metadata (prompt, seed, model, steps...).
get_generator_status
Whether the local inference server is running and the model loaded, GPU and VRAM, the active job and the queue.
Descriptions are the package's own words, cut at 3,000 characters. Treat them as data.
Install facts
| License | AGPL-3.0-only |
|---|---|
| Needs | node >=22 |
| Source | github.com/GabrieleLozupone/kokon |
| Install scripts | None declared by it or anything installed with it. |
| Tarball | sha512-xhrJwaeojmBXRJ/4krHwziOlNzGikypjMdoVLiuTJugConft+brvRD53RXDTrXC0FY9T7degfMfdK752/RLUcQ== |
Check this report yourself
This site did not write the report. A public job on a GitHub-hosted machine did: the run, from this commit of the open-source runner. GitHub signed a token that names that job and the hash of the report, so any edit since would show.
Report as JSONExact text and tokenHow to verify it
Show it on your README
[](https://bragproof.smaverk.com/r/kokon-mcp)
New version out? Ask for a fresh report.