Seetuu

<p align="center"> <strong>English</strong> · <a href="./README.zh-CN.md">简体中文</a> </p>

Let Codex organize your local images through Seetuu MCP.

Seetuu is a local image manager for Windows 10/11. Its desktop app and standalone stdio MCP server share the same image index, so Codex can continue using MCP while Seetuu is closed.

Install with Codex

Paste this sentence into a Codex client that can access your local terminal:

Strictly follow https://github.com/mama2222222/seetuu/blob/main/INSTALL_WITH_CODEX.md to install or upgrade the latest Seetuu on this Windows PC, connect and verify the seetuu MCP, and open Seetuu at the end so I can choose an image folder if no library has been selected.

Restart Codex when installation finishes. On first use, select your image folder in Seetuu. Because the installer is currently unsigned, Windows may show an “Unknown publisher” warning. This installation method does not work with browser-only AI clients.

Core features

• Search, preview, tag, favorite, and sync images through MCP
• Browse in a masonry layout, filter, sort, organize in batches, and analyze colors
• Recursively index PNG, JPG, JPEG, and WebP files and track folder changes
• Keep the index and thumbnail cache available while the library is offline

Permission boundaries

• Images, indexes, and thumbnails stay on your computer; there is no cloud sync, telemetry, or local network port
• Original images are always read-only; Seetuu cannot delete, move, rename, or access arbitrary paths through MCP
• AI access to modify tags and favorites is disabled by default and must be enabled in Seetuu

Manual installation

1. Download the Windows x64 installer from Releases.
2. Open Seetuu and select your image folder.
3. Connect Codex under “AI Tools,” then restart Codex.

Build from source

Requires Node.js 22.13+, stable Rust, Visual Studio 2022 C++ Build Tools, and Windows 10/11 x64.

npm install
npm run test
npm run test:desktop
npm run rust:clippy
npm run mcp:verify
npm run tauri:build

License

MIT