Albumen
Read-only MCP over an open-source photo library that never alters your originals
- Pricing
- Open source
- Platforms
- CLI, self-hosted, Linux
- Runs
- Locally
- Version
- 0.1.1
- Listing updated
- today
Similar MCP servers
About Albumen
Albumen is an open-source MCP server for files and documents. It runs locally on your machine and is started by your AI client.
Albumen is an early-stage open-source photo library whose design promise is that originals and metadata are never lost. Files are stored bit-exact with no recompression or stripping, EXIF, XMP, IPTC, GPS and sidecars stay, and every copy is verified with SHA-256. Sources are read-only, and a destination inside a source is refused with no override.
The MCP server speaks stdio and lets an agent search and browse the library, including metadata search by capture date, camera, lens, GPS box and XMP or IPTC keywords and captions, and read a ledger of stored files, analyses and destinations. Export and upload tools are off until the process starts with --enable-export or --enable-upload, and there is no delete tool at all.
Storage stays where you put it, such as local disk, NAS, SMB, SFTP, WebDAV, S3 or Backblaze B2. Native macOS, iOS and Android apps and an on-disk catalog are not built yet. The server is available as a Rust build or an OCI container, and metadata search needs ExifTool.
Install
Run in a terminal
claude mcp add albumen -- docker run -i --rm ghcr.io/jay-the-maker/albumen-mcp:0.1.1Add to claude_desktop_config.json
{
"mcpServers": {
"albumen": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/jay-the-maker/albumen-mcp:0.1.1"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"albumen": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/jay-the-maker/albumen-mcp:0.1.1"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"albumen": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/jay-the-maker/albumen-mcp:0.1.1"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"albumen": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/jay-the-maker/albumen-mcp:0.1.1"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"albumen": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/jay-the-maker/albumen-mcp:0.1.1"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
What it does
- Bit-exact originals
- No recompression, transcoding or metadata stripping.
- Metadata search
- Search by date, camera, lens, GPS box and keywords.
- Ledger
- Lists stored files, on-device analyses and destinations.
- Opt-in export
- Export and upload tools are off unless enabled.
- No delete tool
- Agents cannot remove or rewrite originals.
- Bring your storage
- Local disk, NAS, S3, B2 and more.
Good for
- Find photos by camera and date range through an assistant
- Review what the library has stored and analysed
- Export a copy to a backup destination with verification
- Keep an archive agent-readable but not editable
Pricing
Open source
Albumen FAQ
Can an agent delete my photos?
No. The server has no delete tool and sources are read-only.
Is it a hosted service?
No. You bring your own storage.
What is its status?
Early-stage; native apps and the on-disk catalog are not built yet.
What does metadata search need?
ExifTool on PATH.
Is Albumen free?
Yes. Albumen is open source, so you can use and self-host it for free.
How do I add Albumen to Claude Code?
Run this command in your terminal: claude mcp add albumen -- docker run -i --rm ghcr.io/jay-the-maker/albumen-mcp:0.1.1
What are the best alternatives to Albumen?
The closest alternatives to Albumen are HyperFrames by HeyGen, next-ai-draw-io, mcp-for-blender, ffmpeg-skill and cursor-talk-to-figma-mcp.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.



