# imagegrain MCP

Local [MCP](https://modelcontextprotocol.io) server and Claude Desktop extension for [imagegrain](https://imagegrain.com). 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`](packages/grain) — `@imagegrain/grain`, the DOM-free grain engine
- [`packages/mcp`](packages/mcp) — `@imagegrain/mcp`, the stdio MCP server and `.mcpb` pack

## Requirements

- Node.js 18.17 or newer

## Test

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

## Claude Desktop extension

```bash
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