Skip to content
MCP server

Albumen

Read-only MCP over an open-source photo library that never alters your originals

Runs locallyStatus and history
Install
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.1

Add to claude_desktop_config.json

{
  "mcpServers": {
    "albumen": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/jay-the-maker/albumen-mcp:0.1.1"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "albumen": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/jay-the-maker/albumen-mcp:0.1.1"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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.

How AIPoweredBot checks servers