Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Idra Photo make 10 photos in the exact same style as this image: a red sports car on a beach at sunset"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Your AI generates. Idra manages the batch.
Drag a photo into Codex, type one prompt, say how many images you want. Codex makes every image with its own built-in image tool. Idra hands Codex one job at a time, saves each finished image into a numbered folder, and remembers where the batch stopped so you can pick it up later.
No image API key, no extra image service, no web dashboard.
Everything Idra stores stays on your computer.
Idra itself never generates images and never makes network requests. Codex still uses its own image service and your own Codex plan.
Status: v0.1. Tested end to end in the Codex desktop app on Windows with real image generation: a 3-image same-style batch and a 4-character counterpart batch, each finished in one Codex turn. The macOS/Linux launcher passes the automated tests on GitHub but has not been tried with Codex on a real Mac yet. Evidence: Compatibility.
Paste this into Codex (the desktop app or CLI). Codex downloads Idra, connects it, and checks it.
Install the Idra Photo MCP server for me.
Source: https://github.com/bbrainfuckk/idra-photo (public, MIT license)
1. Use a permanent folder: %USERPROFILE%\idra-photo on Windows, ~/idra-photo on macOS or Linux. Not a temp folder, because Codex runs Idra from there.
2. Get the code: git clone https://github.com/bbrainfuckk/idra-photo.git into that folder. If git is not installed, download https://github.com/bbrainfuckk/idra-photo/archive/refs/heads/main.zip and unzip it there instead. Do not run npm install. The server is prebuilt in idra-photo.mjs.
3. From inside that folder, register it with Codex:
Windows: .\idra-photo.cmd install-codex
macOS/Linux: sh ./idra-photo.sh install-codex
This adds one entry named idra_photo to my Codex config and creates an "Idra Photo" folder in my home folder. My other settings stay as they are. If you need permission to write outside the workspace, ask me.
4. Check it:
Windows: .\idra-photo.cmd doctor
macOS/Linux: sh ./idra-photo.sh doctor
Every line should say ok or info. If it says Node is missing or too old, tell me to install Node.js 22.13 or newer from nodejs.org.
5. Tell me the result and remind me to fully restart Codex.
After the restart I will use it by dragging in a photo and saying:
"Use Idra Photo: make 10 photos in the exact same style as this image, <my idea>"Related MCP server: smartapi-images
Get the folder: git clone https://github.com/bbrainfuckk/idra-photo.git, or download the ZIP and unzip it anywhere.
Windows: double-click install.cmd. macOS/Linux: run sh install.sh in the folder.
Restart Codex.
That is all. No npm install: the server ships prebuilt as one file, idra-photo.mjs.
What the installer does:
Creates Idra Photo in your home folder. Your images go to Idra Photo/outputs/.
Registers idra_photo with Codex. Your other Codex settings are kept, and a backup is made if it has to edit config.toml itself.
Lets Idra read photos you drag in from Downloads, Desktop, Pictures, temp, and Codex's own generated-images folder.
Idra needs Node.js 22.13 or newer. On Windows, if you do not have Node, Idra uses the Node that ships inside Codex. The launcher looks for Node every time Codex starts it, so Codex or Node updates do not break it.
Options: install.cmd --workspace "D:\Shoots\Idra" picks another folder. --dry-run only shows what would be written.
Remove it any time (your images stay):
idra-photo.cmd uninstall-codexOn macOS/Linux use sh idra-photo.sh uninstall-codex. Check that everything is ready with idra-photo.cmd doctor.
Drag your photo into the Codex chat and write something like:
Use Idra Photo. Make 20 photos in the exact same style as this image: a woman holding our vitamin C serum in a sunny garden. 4:5.
Codex creates the batch, then loops: get a job, generate the image, report it, get the next one. Images land in:
Idra Photo/outputs/<batch-name>/
001-a-woman-holding-our-vitamin-c-serum.png
002-a-woman-holding-our-vitamin-c-serum.png
manifest.jsonMore things you can say:
You say | What happens |
"Idra status" / "how far is my batch?" | Counts and where it stopped |
"Pause the batch" | No new images start. One already generating can still finish. |
"Resume it" | Makes the remaining jobs available again. Codex continues. |
"Cancel it" | Stops new work. Saved images stay. |
"Retry the failed ones" | Re-queues failures that are safe to retry. Safety refusals are never retried or reworded. |
"Make 10 more" | Adds jobs 21-30 with the same style, references, and rules. |
"Make 5 different concepts: beach, café, gym, office, night" | Diversified mode: one concept per image. |
"Use these exact prompts: ..." | Explicit mode: your prompts, unchanged. |
Codex passes these as rules on every image. They are prompt requirements, not pixel locks. Check the results yourself.
Style: match the reference's color grading, light, lens look, and mood.
Product: keep the packaging, label, logo, colors, and proportions.
Identity: keep a person recognizable.
Text: render given words exactly.
Composition: keep framing and placement.
Each can be off, high, or strict. A valid image file is not proof the product or face was preserved. Idra records whether a visual review was actually done.
Codex closed mid-batch. Say "resume my Idra batch". If an image was saved to its job folder but never reported, Idra adopts it and does not make it again. If Idra cannot tell whether it was made, it asks you before regenerating.
Usage limit or tool unavailable. The batch pauses. Idra never guesses when limits reset and never switches providers. Resume later.
Codex stops after one image. Some hosts end the turn after each image. Say "continue" to go on; Idra keeps the place.
Idra only reads your workspace folder and the folders listed with --allow-import, which by default are Downloads, Desktop, Pictures, temp, and Codex's generated-images folder. It only accepts PNG, JPEG, and WebP images from them, and copies references into the workspace.
It never reads Codex login files and never asks for passwords, tokens, or API keys.
No telemetry. Idra makes no network requests at runtime.
Idra does not make image generation free or unlimited. Every image uses your Codex plan.
npm installnpm testnpm run bundle rebuilds idra-photo.mjs from src/. Commit it with your change; CI fails if it is stale.
MIT licensed. See LICENSE. Bundled open-source packages and their licenses are listed in THIRD_PARTY_NOTICES.md.
This server cannot be deployed
LLM chat, text tools, image generation, editing, batch image jobs, and asynchronous video generation
AI image + video generation for agents: --flag prompt DSL, async generate/poll, x402 pay-per-use.
Create and manage AI image and video generations through Quriov's fixed public MCP tools.
Design, save, and run outcome-aligned AI workflows and verifiers, with reliable image output.
