Skip to main content
Glama
imagegrain MCP

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: ImageSorcery 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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Enables AI agents to perform deterministic, non-generative image transformations—straightening, cropping, masking, layering, color adjustments, and encoding—as reproducible recipes while preserving immutable originals.
      13
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI assistants to perform local computer-vision-based image recognition and editing, including cropping, resizing, rotating, background removal, drawing text and shapes, object detection, OCR, overlays, and metadata inspection without sending images to external servers.
      MIT
    • A
      license
      B
      quality
      C
      maintenance
      Enables AI agents to drive a full photo-editing engine through validated, non-destructive operations — exposure and colour grading, effects, geometry, text/watermarks, style matching from a reference image, natural-language looks, and batch processing over folders. Originals stay untouched, edits live in an open JSON project format, and everything runs locally without network access unless opted in.
      27
      Apache 2.0