Skip to main content
Glama
imagegrain

imagegrain MCP

Official
by imagegrain

imagegrain MCP

Local MCP server and Claude Desktop extension for imagegrain. It applies deterministic film grain and analog adjustments to photos on your machine. Nothing is uploaded.

This repository is the public source for the Desktop extension. The website lives in a separate private repo.

Packages

  • packages/grain@imagegrain/grain, the DOM-free grain engine

  • packages/mcp@imagegrain/mcp, the stdio MCP server and .mcpb pack

Related MCP server: Local Vision MCP

Requirements

  • Node.js 18.17 or newer

Test

cd packages/grain && npm install && npm test
cd ../mcp && npm install && npm test && npm run validate:mcpb

Claude Desktop extension

cd packages/mcp
npm install
npm run pack:mcpb

Install the generated packages/mcp/imagegrain.mcpb in Claude Desktop (Settings → Extensions, or double-click the file). Then ask:

Add medium film grain at intensity 40 to C:\Users\You\Pictures\photo.jpg

License

MIT

Related MCP Connectors

Related MCP Servers

  • A
    license
    B
    quality
    B
    maintenance
    Enables controlling GIMP 3 locally through natural language, providing tools for image editing, layer management, selections, and PDB procedure invocation. Keeps all images and files on the user's machine with a local-first, secure design.
    40
    1
    GPL 3.0
  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables AI agents to process images locally via file paths—converting, resizing, removing backgrounds, smart cropping, upscaling, reading or stripping metadata, and batch processing—without files ever leaving the device.
    MIT