Metadata-Version: 2.5
Name: mfluxible-mcp
Version: 0.9.1
Summary: An MCP tool that generates images through a running mfluxible server.
Project-URL: Homepage, https://github.com/wesbiggs/mfluxible
Project-URL: Documentation, https://github.com/wesbiggs/mfluxible/blob/main/docs/mcp.md
Project-URL: Source, https://github.com/wesbiggs/mfluxible
Project-URL: Issues, https://github.com/wesbiggs/mfluxible/issues
Author: Wes Biggs
License-Expression: Apache-2.0
Keywords: claude,image-generation,mcp,mfluxible
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Multimedia :: Graphics
Requires-Python: >=3.11
Requires-Dist: httpx>=0.27
Requires-Dist: mcp-types>=2.1.1
Requires-Dist: mcp>=2.1.1
Requires-Dist: pillow>=10
Description-Content-Type: text/markdown

# mfluxible-mcp

An [MCP](https://modelcontextprotocol.io) tool that generates images by calling a
running [mfluxible](https://github.com/wesbiggs/mfluxible) server.

This is the client half. It makes HTTP calls and installs nothing heavy — no mflux, no
MLX, no PyTorch — so it can live on a machine that isn't the one with the GPU. The
server it talks to is the `mfluxible` package, which does need Apple Silicon.

```bash
uvx mfluxible-mcp
```

Three tools: `generate_image` (text-to-image, image-to-image, and inpainting with
rectangular mask regions), `check_image` (collect a generation that outlived the host's
tool-call timeout), and `preview_mask` (render a mask selection over an image without
touching the GPU).

Point it at a server with `MFLUXIBLE_URL`; it defaults to
`http://127.0.0.1:8420/mfluxible/v1/images/generations`.

**[Full documentation, including how to register it with each tested MCP host.](https://github.com/wesbiggs/mfluxible/blob/main/docs/mcp.md)**

Apache-2.0, same as the rest of the project.
