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"] } } }