cowlsly/image-toolbox-mcp_by-cowlsly
Productivity workflow이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기
An open-source Model Context Protocol (MCP) integration for Image Toolbox, enabling AI assistants to access image conversion, editing, compression, metadata, and batch-processing workflows.
개요
An open-source Model Context Protocol (MCP) integration for Image Toolbox, enabling AI assistants to access image conversion, editing, compression, metadata, and batch-processing workflows. Developed by Cowlsly as an independent integration with attribution to the original project. No working MCP server yet. See roadmap.md and docs/PROJECT_STATE.md. Image Toolbox is an Android image editor by , licensed under Apache-2.0. This project is independent and is not affiliated with or endorsed by the Image Toolbox authors. It currently contains Image Toolbox source code; image processing is done by its own Python engine built on Pillow. See docs/audit/upstream-audit.md. Python 3.10+ server, Pillow image engine, official MCP Python SDK over stdio. Rationale: ADR-0001. Termux (Android): pkg install python python-pillow, then pip install mcp — still being verified, see docs/PROJECT_STATE.md. More in CONTRIBUTING.md; security reports: SECURITY.md.
README
원문 README의 일부입니다. 원문 보기.
Image-Toolbox-MCP_By-Cowlsly
An open-source Model Context Protocol (MCP) integration for Image Toolbox, enabling AI assistants to access image conversion, editing, compression, metadata, and batch-processing workflows. Developed by Cowlsly as an independent integration with attribution to the original project.
Status: early development. A minimal MCP server works with seven tools:
image_inspect(read-only),image_convert(JPEG/PNG/WebP),image_resize,image_compress,image_rotate_flip,image_cropandimage_batch(one operation on a whole folder). See roadmap.md and docs/PROJECT_STATE.md.
Attribution
Image Toolbox is an Android image editor by T8RIN (Malik Mukhametzyanov), licensed under Apache-2.0. This project is independent and is not affiliated with or endorsed by the Image Toolbox authors. It currently contains no Image Toolbox source code; image processing is done by its own Python engine built on Pillow. See docs/audit/upstream-audit.md.
How it works
Python 3.10+ server, Pillow image engine, official MCP Python SDK over stdio. Rationale: ADR-0001.
You choose one input folder; the server can only read images inside it. Paths with .., symbolic links, and absolute paths outside the folder are refused. Originals are never modified. New files go into one output folder (default imagetoolbox-out inside the input folder, or --out DIR); existing files are never overwritten — a -1, -2… suffix is added instead. There are no shell, network or general file tools. Output rules: ADR-0002.
| Tool | What it does |
|---|---|
image_inspect |
Format, width/height, colour mode, alpha, frames, file size, orientation, a safe EXIF subset. GPS is never returned — only whether it is present. |
image_convert |
Convert to jpeg, png or webp (quality 1–100, WebP lossless). Applies EXIF rotation, removes EXIF/GPS, keeps the colour profile. Optional output_name (no folders, no extension). |
image_resize |
Resize by width, height or both. fit: contain (default, keep aspect inside the box), cover (fill and centre-crop), exact (stretch). resample: lanczos (default), bicubic, bilinear, nearest (pixel art). Never enlarges unless allow_upscale. Keeps the source format (JPEG/PNG/WebP, else PNG) unless format is set. Same metadata rules as convert. Default name -x. |
설치
This server does not publish a one-line install command.
Open the repository installation guide MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →설정
{ "mcpServers": { "imagetoolbox": { "command": "imagetoolbox-mcp", "args": ["--root", "/path/to/images"] } } }