# ouestcharlie-woof

Browse and search your local photo and video archive from your AI assistant while keeping media files strictly on your own drive.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 8
- Author: ouestcharlie
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ouestcharlie/ouestcharlie-woof
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/mcp/ouestcharlie-woof

## What it does

Woof acts as an MCP interface for the Où est Charlie framework. It indexes local media folders and exposes camera metadata, dates, GPS bounding boxes, and hierarchical tags directly to your coding assistant. Original assets remain untouched because annotations are written into XMP sidecar files and companion JSON manifests.

Your image files stay private. The server serves thumbnails locally via loopback, passing text metadata alone into the chat context. Automatic re-indexing does not trigger on its own yet, so refreshed directories require manual updates. Support for HEIC and RAW files depends on your build configuration.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add ouestcharlie-woof -- uvx ouestcharlie-woof
```
uvx runs the command named after the package; if the README names another one, use uvx --from ouestcharlie-woof <command>

### Codex

**Platform CLI**
```bash
codex mcp add ouestcharlie-woof -- uvx ouestcharlie-woof
```
uvx runs the command named after the package; if the README names another one, use uvx --from ouestcharlie-woof <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "ouestcharlie-woof": {
            "command": "uvx",
            "args": [
                "ouestcharlie-woof"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from ouestcharlie-woof <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "ouestcharlie-woof": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "ouestcharlie-woof"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from ouestcharlie-woof <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add ouestcharlie-woof uvx ouestcharlie-woof
```
uvx runs the command named after the package; if the README names another one, use uvx --from ouestcharlie-woof <command>

## When to use it
- search local photo collections by camera settings, aperture, or tags
- filter pictures using GPS bounding boxes and capture timestamps
- inspect video dimensions and runtimes directly within the terminal assistant
- manage metadata via open XMP sidecars without vendor database lock-in

## Example prompts
- Find photos taken with a 50mm lens in France from my local library.
- Show preview thumbnails for videos longer than 30 seconds tagged with Nature.
- Filter images by GPS bounding box around Paris taken between June and August.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47577
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43902

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md