Metadata-Version: 2.4
Name: dcc-mcp-krita
Version: 0.2.0
Summary: Krita adapter for the DCC Model Context Protocol
Project-URL: Homepage, https://github.com/dcc-mcp/dcc-mcp-krita
Project-URL: Repository, https://github.com/dcc-mcp/dcc-mcp-krita
Project-URL: Issues, https://github.com/dcc-mcp/dcc-mcp-krita/issues
Author-email: loonghao <hal.long@outlook.com>
License: MIT
License-File: LICENSE
Keywords: automation,dcc,image-editing,krita,mcp
Requires-Python: >=3.9
Requires-Dist: dcc-mcp-core<1.0.0,>=0.19.38
Provides-Extra: dev
Requires-Dist: build>=1.2; extra == 'dev'
Requires-Dist: pytest>=8; extra == 'dev'
Requires-Dist: ruff>=0.8; extra == 'dev'
Requires-Dist: twine>=6; extra == 'dev'
Description-Content-Type: text/markdown

# dcc-mcp-krita

![DCC-MCP Krita](docs/images/dcc-mcp-krita.svg)

Krita adapter for the DCC Model Context Protocol ecosystem.

![Krita game-art workflow](docs/images/dcc-mcp-krita-showcase.webp)

The adapter uses a small Krita Python plug-in and a loopback JSON-lines bridge.
The MCP server runs in the normal Python environment; KRITA API calls stay inside
the plug-in process. It does not expose arbitrary Python or Script-Fu execution.

## Install

```bash
pip install dcc-mcp-krita
dcc-mcp-krita-install
```

Restart Krita, enable the bundled Python plug-in, then start:

```bash
dcc-mcp-krita
```

The MCP endpoint defaults to `http://127.0.0.1:8767/mcp`; the plug-in bridge uses
`127.0.0.1:3848`. Override the latter with `DCC_MCP_KRITA_BRIDGE_PORT` before
starting both processes.

## Current tools

- Check KRITA bridge status and version.
- List open images with dimensions.
- Inspect the active image.

The first release targets safe session discovery. Image mutation and export will
be added only through typed KRITA procedures, not arbitrary source evaluation.

## Development

```bash
python -m pip install -e ".[dev]"
python -m pytest
python -m ruff check src tests tools
python tools/lint_skills.py
python -m build
python -m twine check dist/*
```

Krita plug-in API reference: https://developer.krita.org/api/3.0/
