Skip to main content

dcc-mcp-gimp

GIMP 3 adapter for the DCC Model Context Protocol ecosystem.

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

Install

pip install dcc-mcp-gimp
dcc-mcp-gimp-install

Restart GIMP, run Filters → Development → DCC-MCP GIMP Bridge, then start:

dcc-mcp-gimp

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_GIMP_BRIDGE_PORT before starting both processes.

Current tools

  • Check GIMP 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 GIMP procedures, not arbitrary source evaluation.

Development

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/*

GIMP 3 plug-in API reference: https://developer.gimp.org/api/3.0/

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

dcc_mcp_gimp-0.2.0.tar.gz (7.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

dcc_mcp_gimp-0.2.0-py3-none-any.whl (10.0 kB view details)

Uploaded Python 3

File details

Details for the file dcc_mcp_gimp-0.2.0.tar.gz.

File metadata

  • Download URL: dcc_mcp_gimp-0.2.0.tar.gz
  • Upload date:
  • Size: 7.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for dcc_mcp_gimp-0.2.0.tar.gz
Algorithm Hash digest
SHA256 2b1a5550498fda8d26753b03603988984beda1a65ce7f7906f7b0e283f0cc343
MD5 ebf7b614305a6bf285525961c259b490
BLAKE2b-256 b59400a5a6f950de01d3c425550bef93a3f32be0e6bc4983cf09d8623a1cd27a

See more details on using hashes here.

Provenance

The following attestation bundles were made for dcc_mcp_gimp-0.2.0.tar.gz:

Publisher: release.yml on dcc-mcp/dcc-mcp-gimp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file dcc_mcp_gimp-0.2.0-py3-none-any.whl.

File metadata

  • Download URL: dcc_mcp_gimp-0.2.0-py3-none-any.whl
  • Upload date:
  • Size: 10.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for dcc_mcp_gimp-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 456b98dd98f47d0917c62ce768afd34356a282b16fa9a6071dc34220ee9f6eed
MD5 b652299a80533011b768d8982a49b52c
BLAKE2b-256 9b2b138fac4b3e5644c36b8d3e148e4179d3c2c50a4fe69079aeae1803d801b8

See more details on using hashes here.

Provenance

The following attestation bundles were made for dcc_mcp_gimp-0.2.0-py3-none-any.whl:

Publisher: release.yml on dcc-mcp/dcc-mcp-gimp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page