# Scouter MCP server

> Allows an AI client to edit photos in darktable through conversational commands and manage photo libraries via the Lua API.

- Repository: https://github.com/pratikgh0se/scouter
- Page: https://hostedmcp.org/servers/pratikgh0se/scouter
- Transport: —
- Stars: 0
- License: MIT

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `SCOUTER_HOST_TESTS` | no | no |  |
| `SCOUTER_JOB` | no | no |  |

## Tools (10)

- `view_photos`
- `rate_photos`
- `import_batch`
- `list_styles`
- `apply_preset`
- `import_from_camera`
- `extract_previews`
- `apply_ratings_batch`
- `open_in_darktable`
- `export_images`

## FAQ

### How does Scouter ensure photo edits are applied correctly?

Scouter confirms every write by reading the XMP sidecar back. If darktable writes an older history over it, Scouter refuses the write and restores the sidecar.

### Can I use Scouter to import photos from a camera?

Yes, the server includes a tool to detect a camera via libgphoto2 and copy photos to a local directory, supporting both PTP and USB Mass-Storage.

### Does Scouter modify the darktable library database directly?

No, Scouter never writes to darktable's library.db and uses the official Lua API and darktable-cli instead.

### How can I preview the edits made by the AI?

The server can render previews using darktable-cli in an isolated configuration so the agent can view the result.
